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MAXIMUM PERFORMANCE. . . Unleash the 
Power of the 386! 

Concurrent™ DOS uses the power of the 386 to efficiently 
combine its multiuser, multitasking design with the added 
value of DOS compatibility. Up to ten users can share the 
resources of a single system through easy-to-connect serial 
terminals as configured. Digital Research provides tools for 
those VARs and OEMs needing to expand beyond ten users. 


MAXIMUM COMPATIBILITY . . . Runs Multiuser 
Applications While Simultaneously Running Many Popular 
PC-DOS Applications. 

The applications running on your current system (Lotus® 
1-2-3®, dBase® III, WordPerfect® and many more) are still 
usable and don’t have to be replaced with “‘work-alikes”’ and 
“compatibles.”” Multiple DOS applications can be run from 
serial terminals while the system console can execute as many 
as four applications concurrently. 


MINIMUM INVESTMENT. . . Protect Your 
Development Investment with Easy Migration within the 
Intel® Microprocessor Family. 


Take advantage of developed and proven application software 
that provides solutions for businesses that range from medical 
practices to manufacturing floors. A library of Concurrent 
DOS multiuser applications already exists to meet the diverse 
requirements of many end-user environments. 


FEATURES: 


PC DOS 3.3 Compatible. 

Supports IBM®Personal System/2™ Model 80, Compaq® 
Deskpro® 386 and 100% Compatibles. 

Executes Multiple Applications on Serial Terminals. 
Simultaneously Executes Up to 255 Different Tasks. 
Supports Multiusers Sharing System Resources. 

Easy to Install and Operate. 

Full Complement of Development Tools and Over 1000 
Business Solutions Available. 

AT Performance at the Serial Terminals. 

Serial Port Configurability Up to 38.4K Baud. 


Call Today and Receive a FREE Poster of Single-User and 
Multiuser Concurrent DOS Applications. 


1-800-443-4200. 
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Concurrent is a trademark, and Digital Research and the Digital Research logo are registered trademarks of Digital Research Inc. IBM is a registered trademark and Personal System/2 is a trademark of International Business Machines 
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IF you program in C, take a few 


moments to learn how Windows for 
Data can help you build a state-of-the- 
art user interface. 


if Create and manage menus, data-entry forms, context- 
sensitive help, and text displays — all within windows. 


@ Develop window-based OS/2 programs right now, 
without the headaches of learning OS/2 screen manage- 
ment. Run the same source code in PCDOS and OS/2 
protected mode. 


M Build a better front end for any DBMS that has a C- 
language interface (most popular ones do). 
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FROM END TO BEGINNING 
Windows for Data begins 
where other screen packages end, 
with special features like nested 
pop-up forms and menus, field en- 
try from lists of choices, scrollable 
regions for the entry of variable 
numbers of line items, and an ex- 
== — clusive built-in debugging system. 
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NO WALLS 
If you've been frustrated by the limitations of other 
screen utilities, don’t be discouraged. You won't run into 
walls with Windows for Data. Our customers repeated- 
ly tell us how they've used our system in ways we never 
imagined — but which we anticipated by designing Win- 
dows for Data for unprecedented adapatability. You will 
be amazed at what you can do with Windows for Data. 
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YOU ARE ALWAYS IN CHARGE 
Control functions that you write and attach to fields 
and/or keys can read, compare, validate, and change the 
data values in all fields of the form. Upon entry or exit 
from any field, control functions can call up subsidiary 
forms and menus, change the active field, exit or abort 
the form, perform almost any task you can imagine. 
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OUR WINDOWS 
WILL OPEN DOORS 
Our windows will open doors to 
new markets for your software. 
High-performance, source-code- 
compatible versions of Windows 
, \ gl for Data are now available for 
N ‘i PCDOS, OS/2, XENIX, 
5 UNIX, and VMS. PCDOS 
versions are fully compatible with Microsoft Windows. 
No royalties. 


MONEY BACK GUARANTEE 

You owe it to yourself and your programs to try 
Windows for Data. If not satisfied, you can return it for 
a full refund. 

Prices: PCDOS $295, Source $295. OS/2 $495. 
XENIX $795. UNIX, VMS, please call. 


Call: (802) 848-7731 ext. 33 
Telex: 510-601-4160 VCSOFT FAX 802-848-3502 
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We've spent years developing our 
file manager so you won't have to. 


You could invest hundreds of programming 
hours writing a file management system for your 
next application. 

Or you could simply invest in Btrieve® 
And get all the file handling functionality you need, 
through subroutine calls from your favorite 
programming language. 

Portable. Write your application once. 
Wherever Btrieve runs, your application will run, 
whether ina single user or multiuser environment. 
In fact, Btrieve is the standard access to NetWare® 

Fast. Written in assembly language, Btrieve 
uses b-tree indexing algorithms with caching 
and automatic balancing for fast, efficient file 
management. 

Safe. Btrieve is the only fault tolerant file 
manager with built-in file recovery. In the event 
of a system or power failure, your database is 
protected. 

Flexible. Develop applications with the 
capabilities you need most. Like 255 open files, 
unlimited records per file, 24 indexes per file, and 


a maximum file size of up to four gigabytes. You 
can access Btrieve from BASIC, C, Pascal, 
COBOL and others. 

Invest in Btrieve. At just $245 for single user 
and $595 for multiuser, it’s a small price to pay for 
all the file manager you'll ever need.* And you'll 
never pay royalties on the applications you devel- 
op. To find out more, see your authorized Novell 
reseller, or call (512) 346-8380. 

For more information, call from your modem 
1-800-444-4472 (8 bit, no parity, 1 stop bit) and 
enter the access code NVBT13. 
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For software solutions, 
you should be seeing red. 


*Suggested retail price (US dollars) ©1987 Novell, Inc., World Headquarters, 122 East 1700 South, Provo, Utah 84601 (801) 379-5900 
Requires PC-DOS or MS-DOS 2.X, 3.X or Xenix. 
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From the 
Editor’s Desk 


Software Battles—Ready For 
Prime Time TV? 


C users are being treated to battles in the software mar- 

ketplace that are beginning to rival the battles we see on 

the evening TV soaps. Who knows, they might become 
the basis for a new TV series that will top the likes of “Dallas,” 
“Falcon Crest,’ and ‘‘Dynasty.”’ After all, those shows are based 
on the competition in businesses like oil, wine, and construction, 
but computer people can’t relate to those goings on. 

What we hackers need is a series we can relate to! I think it is 
time for CBS, NBC, or ABC to start a soap series based on charac- 
ters modeled after the likes of Bill Gates and Phillipe Kahn, 
cloners such as Adam Osborne, and upstart shareware market- 
ers such as Jim Button and Bob Wallace. And there are the hard- 
ware battles, too. Just think of the battles royal between IBM, 
Apple, DEC, AT&T, and the like, and the competing operating 
systems. Takeovers, bankruptcies, sellouts, alliances—it’s all 
there, waiting for the scriptwriters. 

The material for plots is incredible. We could have courtroom 
scenes in which lawyers argue and witnesses testify about the 
“look and feel” of user screen interfaces and the copying of 
microcode. We could have scenes showing what goes on behind 
the closed hotel room doors at big industry trade shows; board 
meetings where the Chairman of the Board is ousted and re- 
placed by the company President he himself hired; and the scene 
could quickly switch to a messy garage where two teenagers, 
dressed in torn jeans and sandals, are making product break- 
throughs that elude multinational companies. And then there are 
things like illegal program copying, vaporware, bug fixing, 
compatibility, etc. We have ready-made plots for a series that will 
lure us away from our system screen to our TV screen and keep 
us on the edge of seat. We could have five or six plots running 
concurrently with enough material to go on for years. 

Actually, I already have the script for the first episode of a 
series on disk and I am trying to peddle it to several TV net- 


works. I will let you know how I make out. 
9 o / fe Jes 


Happy April. 
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PERISCOPE POWER 


susKeeps you going full steam ahead when other 
debuggers let you down! With four models to pick 
from, you'll find a Periscope that has nist the 


power you need. 
Periscope ee 


Start with the model that fits your current needs. If you 
need more horsepower, upgrade for the difference in 
price plus $10! 

When you move to another Periscope model, don’t 
worry about having a lot to learn... Even when you move 
to the most powerful model, Periscope III, an extra dozen 
commands are all that’s involved. 

A Periscope I user who recently began using 
Periscope III writes, ‘‘/ like the 
fact that within the first half 
hour of use I was debugging my 
program instead of learning to 
use the debugger.” 


The Undercover Debugger 


For The IBM Personal te ‘ompater 


by Brew Sales 


Periscope software 
& 200+ page 
manual 


Periscope’s software is solid, comprehensive, and 
flexible. helps you debug just about any kind of program you can 
write... thoroughly and efficiently. 

Periscope's the answer for debugging device-drivers, memory-resident, non-DOS, 
and interrupt-driven programs. Periscope works with any language, and provides 
source and/or symbol support for programs written in high-level languages and 
assembler. 


Periscope’s hardware adds the power to solve the 
really tough debugging problems. The break-out switch lets 
you break into the system any time. You can track down a bug 
instantly, or just check what’s going on, without having to 
reboot or power down and back up. That’s really useful when 
your system hangs! The switch is included with Periscope I, 
Periscope II, and Periscope III. 

Periscope I has a board with 56K of write-protected RAM. 
The Periscope software resides 
in this memory, safe from run- 
away programs. DOS memory, 
where debugger software 
would normally reside, is 
thus freed up for your program. 

Periscope III has a board with 64K of 
write-protected RAM, which performs the 
same function as the Periscope I protected 
memory. AND... 

The Periscope III board adds another powerful dimension to your 
debugging. Its hardware breakpoints and real-time trace buffer let you track down 
bugs that a software- 
oriented debugger would 
take too long to find, or 
can’t find at all! 


Periscope | Board 


Periscope Break-Out 
Switch 


Periscope Ili Board 


“T like the clean, solid design and the crash 
ESCOVEE Periscope I user 
“T like the ability to break out of (a) locked 


ease : 
up system: Periscope II user 


“lam very impressed with Periscope II-X 

..ithas become my ‘heavy duty’ debugger 
of choice, especially if 1 need to work on a 

memory resident utility or a device driver.” 
Periscope II-X user 

. Periscope III is the perfect answer to 

the debugging needs of anyone involved in 
real-time programming for the PC .. . The 
real time trace feature has saved me many 

hours of heartache already.” 


Periscope III user 


i Periscope I includes a half-length 
board with 56K of write-protected RAM; 
break-out switch; software and manual for 
$345. 
Periscope II includes break-out switch; 
software and manual for $175. 


1 Periscope II-X includes software and 
manual (no hardware) for $145. 


H@ Periscope III includes a full-length 
board with 64K of write-protected RAM, 
hardware breakpoints and real-time trace 
buffer; break-out switch; software and 
manual. Periscope III for machines run- 
ning up to 8 MHz is $995; for machines 
running up to 10 MHz, $1095. 

REQUIREMENTS: IBM PC, XT, AT, or close 

compatible (Periscope III requires hardware 

as well as software compatibility); DOS 2.0 or 
later; 64K available memory; one disk drive; 
an 80-column monitor. 

Call us with your questions. We'll be happy 
to send you free information or help you 
decide on the model that best fits your 
needs. 

Order Your Periscope, 

Toll-Free, Today! 


800-722-7006 


MAJOR CREDIT CARDS ACCEPTED 


The ‘il 
PERISCOPE 


Company, Inc. 


1197 PEACHTREE ST. 
PLAZA LEVEL 
ATLANTA, GA 30361 
404/875-8080 


News & Views 


by Sol Libes 


Random Gossip & Rumors 

IBM is rumored to be ready to discon- 
tinue its PC Convertible Model III and 
introduce new 286 and 386 portables. 
After three previous failures, IBM will 
again attempt to compete with 
Compagq in the portable marketplace. 
And there are rumors that IBM is plan- 
ning to have another go at the con- 
sumer computer market with a “PS/ 
2jr” —will they get it right this time? 
Another company with this number of 
duds would have gone out of business. 

AT&T has purchased a 20 percent 
interest in Sun Microsystems. This 
will make AT&T Sun’s largest stock- 
holder and give Sun a terrific and 
much-needed financial shot in the arm. 
Sun and AT&T had previously entered 
into an agreement whereby Sun com- 
mitted to support AT&T’s UNIX efforts 
and AT&T committed to the use of 
Sun’s new Sparc CPU. 

Intel delivered a paper at the Feb- 
ruary International Solid State Circuits 
Conference describing a new RISC- 
type microprocessor chip set. Al- 
though still in development, it includes 
many system-level functions previ- 
ously handled by operating system 
software. 

Apple is rumored to be far along in 
the development of a laptop Mac, with 
an introduction possible as early as the 
second quarter of this year. And 
Tandy Corporation is rumored 
working on a Macintosh clone. 

Microsoft is expected to shortly re- 
lease a version of its C compiler that 
will include a full-screen editor and 
OS/2 tools among other enhance- 
ments. And a new version of the 
Bascom Basic compiler also is ex- 
pected that includes these same 
features. 

Microsoft reports that OS/2 Ver- 
sion 1.1 containing the Presentation 
Manager is now in beta test and is ex- 
pected to be shipping copies to OEMs 
in October. IBM has announced that it 
will ship OS/2 Version 1.1 to dealers in 
October as well. 

And look for Microsoft to release 
Version 1.0 of the LAN Manager in 
July. It is a completely new product, 
which beta testers report is vastly im- 
proved over the old DOS-based MS- 
Net system. Both DOS and OS/2 sys- 
tems can coexist on the net. It will be 
an OEM product (@ Ja OS/2) and sold 
by OEMs, such as 3Com. 
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The PS/2 Compatibles 
Are Coming 
Look for several vendors to introduce 
clones of PS/2 Models 50, 60, and 80 
that are compatible with IBM’s pat- 
ented Micro Channel bus architecture 
at next month’s Comdex show in At- 
lanta. These units are expected to 
have faster clock speeds (look for 
Model 80 clones with 25-MHz clocks), 
larger and higher performance disk 
drives, more memory tightly coupled 
to the CPU, memory caching, im- 
proved VGA, and other features that 
are not available on the IBM units. 
Clone vendors are rumored to include 
Kaypro, Compag, and smaller com- 
panies using chips and board designs 
from Chips & Technology and 
Western Digital. These companies 
are known to be working on obtaining 
PS/2 licensing agreements from IBM. 
However, it is not yet clear what steps 
IBM will take to protect its products. 
Production shipments of these units 
are expected as early as June. IBM 
anticipating introduction of these units 
recently instituted price cuts on its 
units. IBM also is expected to respond 
shortly with upgraded PS/2 systems. 
C&T has already shown PS/2 proto- 
type boards for the Models 50 and 60 
that have almost half as many chips 
(from 119 down to 68) as the IBM 
boards. And C&T sources claim that its 
Model 80 (80386) board has only 66 
ICs compared to 179 on IBM’s board. 


OS/2—Early Reports 

Early reports from OS/2 users indicate 
that OS/2 has some problems that will 
require additional work on the part of 
IBM and Microsoft. Multitasking is re- 
ported to be several times slower than 
comparable operations run under 
Xenix on the same hardware. Also, 
OS/2 cannot reliably handle 9,600- 
baud communications via serial ports 
when multitasking. 

Users who have attempted to bring 
up IBM’s implementation of OS/2 on 
non-IBM systems report that, in many 
cases, it will not even boot, or when it 
does boot there may be problems with 
software that works with peripheral 
devices. OS/2 bypasses the AT sys- 
tem’s BIOS ROM making OS/2 a more 
stringent test of hardware compatibili- 
ty. Device driver software must be 
provided for system boards and plug-in 
board products. 


Compaq has reported that IBM’s 
OS/2 runs without modification on all 
of its 286/386-based systems. None- 
theless, Compaq plans to introduce its 
own version. Users who want to run 
OS/2 on AT clones and find that the 
vendor does not plan to release a ver- 
sion of OS/2 for their systems may find 
that they will have to try implementa- 
tions from different vendors in the 
hope of finding one that will run on 
their system. If none can be found, 
they will find themselves shut out from 
running OS/2 on their AT clones. 

Microsoft has indicated that it is al- 
ready at work on OS/2 improvements. 
In the works are support for multiple 
processors and improved memory 
management for 386-based systems. 
The PS/2 has a multiprocessing bus ar- 
chitecture, but as yet no plug-in prod- 
ucts take advantage of it and neither 
DOS nor the current version of OS/2 
provide for processor arbitration. 


Floppy Software 

Density Increases 

Many PC application software packages 
have grown so large in size that some 
suppliers are now furnishing them in ar- 
chived (compressed) form on floppy 
disks along with software to unarchive 
the programs and do automatic installa- 
tion. The result is a typical savings of 
20-40 percent in disk cost as some 
packages would otherwise require as 
many as 20 floppy disks. 

Vendors of software for OS/2 are 
furnishing their software on high-den- 
sity 1.4-MB disks. When this software 
is archived, more than 2MB of software 
can be shipped on one floppy disk. 


386 Systems In High Demand 
Dataquest, a market researcher that 
tracks PC sales, predicts that roughly 
one million 386 systems will be sold 
this year. The 386 share of the mar- 
ketplace will also equal that of 8088- 
based systems. 286-based systems 
now occupy the largest share of the PC 
market. The likelihood is that 386- 
based systems will overtake 8088- 
based systems next year. 

286-based systems are now consid- 
ered the system for general use and 
are expected to be the dominant sys- 
tem this year and next. 386-based sys- 
tems are chosen when speed is impor- 
tant—for power hungry applications 
such as CAD, desktop publishing, net- 
work file servers, and multiuser sys- 
tem hosts. 

IBM and Compaq are the dominant 
386 system suppliers, with Compaq 
reported to have a slight edge over 
IBM by virtue of its early introduction 
of a 386-based system. Also, Compaq 
has stayed ahead by introducing a 20- 
MHz machine with added features. [] 
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In Search of the Missing Code 
To the editor, 

I observed with horror that the listings 
that accompanied my article in the Jan- 
uary 1988 issue (‘“‘A Hardware Break- 
out Switch for PC-DOS’s Debug,’”’ page 
46) looked as though it had been 
through a demented text formatter. 
The result probably stemmed from an 
incompatibility between WordStar’s 
tab handling in non-document mode 
and Micro/System’s layout word pro- 
cessor. Nonetheless, I’m sure that 
most readers should be able to deci- 
pher the listing. 

However, coupled with the fact that 
the last eight lines were left off the 
published listing, I suspect even Cham- 
pollion himself would have trouble 
working it out. I hope the attached 
partial listing (Listing 1) will help those 
who wish to type the listing into their 
computer. 

Alex Cameron 

Surrey Downs, Australia 


From the Editor: Our apologies to our 
readers and to Mr. Cameron. The 
problem ts, indeed, one of translation 
that has since been resolved. For those 
who are interested, the corrected 
source code is available from M&T 
Publishing on an MS-DOS disk, as 
well as on CompuServe (type GO DDJ 
FORUM). 


That Was Then, This Is Now 
Dear Micro/Systems: 
Your February issue arrived: in my 
mailbox this morning and I thought 
again of the first time I saw Micro/ 
Systems Journal. 

That was quite a while ago (maybe 
three years?), early enough in our com- 
pany’s history that we were still dazzled 


at being able to afford a real office. That 
Micro/Systems Journal was a very 
slim, cheaply printed family effort that 
wanted to give Ziff-Davis a run for its 
money. It was interesting, well-written, 
and certainly spunky, but I didn’t have 
great hope for its survival. 

I congratulate you. Your Journal 
has survived and thrived. I know it 
wasn’t easy. 

Elizabeth G. Bryson 

President 

Golden Bow Systems 

San Diego, California 


PC-Plus Has Been Improved 
Dear Micro/Systems: 

We appreciated the article by Dr. A.L. 
Bender on Alloy’s PC-Plus network 
(Micro/Systems, January 1988). We 
would like to add a few comments to 
update the information in the article. 

In addition to the QICSTOR-Plus and 
12-slot X-bus, Alloy now provides a 4- 
slot expansion bus. The 4- and 12-slot 
expansion buses are optionally available 
with a new version of the HI card—the 
HI/2—that permits the expansion 
buses to be attached to the Micro Chan- 
nel bus of IBM’s new Personal System/ 
2, Models 50, 60, and 80. Alloy’s PC- 
Plus also operates directly with the 
hard disks delivered with IBM’s PC/XTs 
and ATs, and most compatibles—it is 
not necessary to use Alloy add-on hard 
disks as Dr. Bender did. 

We have introduced a new Slave/286 
card, featuring an 8-MHz 80286 pro- 
cessor and one megabyte of RAM for 
users requiring additional computa- 
tional power. The Slave/286 can be op- 
erated in systems with the V20-based 
PC-Slave/16N, allowing CPU require- 
ments to be matched to user needs. 

Alloy has made arrangements with 


Listing 1. The End of Alex Cameron’s Hardware Breakout Switch Program 


MOV 


INT 27h 


; 
NO_INSTALL: 


’ 
INT 
BANNER DB 


20H 


DV,OFFSET END_OF_RESIDENT_CODE+ 1 


‘BREAKNMI - NMI,Keyboard and Timer Vectors' 


DB ' ‘installed.',10,13,'$' 


BREAKNMI 
CSEG 


ENDP 
ENDS 


END BREAKNMI 
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the Harris Corporation for national 
field service. A variety of services are 
available, including hardware installa- 
tion, extended warranty plans, on-site 
service, or carry-in depot repair. Us- 
ers should contact Harris Corporation 
directly at (214) 620-4440. 

David Friesen 

Director of Strategic Marketing 

Alloy Computer Products, Inc. 


A Short-cut for Network 
Programming with Clipper 

Dear Micro/Systems: 

I read with interest the recent article 
“Using dBASE III+ and Clipper A86 
With Novell Netware 286,” by Henry 
J. Franzoni [II (Micro/Systems, Janu- 
ary 1988). 

That Mr. Franzoni should write 
such an article with no reference to 
NetLib, the most popular network 
add-in for Clipper, is amazing; like 
omitting UI programmer from an arti- 
cle about dBASE program generators. 

The features of NetLib are far too 
numerous to describe here. It includes 
all of the features mentioned in Mr. 
Franzoni’s article, plus many station 
numbers, user ID, semaphore locks, 
print spooler control, deadlock avoid- 
ance, journaling (with the latest re- 
lease), and many more. All features are 
accessed by an easy use of syntax and 
require only a few lines of coding by 
the programmer. For example, Mr. 
Franzoni’s article outlines a rather la- 
borious procedure for swapping net- 
work printers. Under NetLib, the 
same task is accomplished by one func- 
tion call: 


N_SPOOL(”=2”) 
&€& switch to 2nd printer 


In addition, NetLib supports many net- 
works and multiuser systems that Clip- 
per alone will not support, such as the 
Alloy PC-Slave (also featured in M1- 
cro/ Systems, January 1988). 

While I can certainly be accused of 
blowing my own horn, I feel that it is 
important that your readers know the 
scope of the tools available to them. 
Keep up the good work. 

Neil Weicher 

President 
Communication Horizons 
New York, N.Y. 


From the Editor: 

We work very hard to provide the most 
complete information we can for our 
readers, including the latest tools as 
well as the latest techniques. Thanks 
for the update. We are always inter- 
ested in hearing more about products 
that improve productivity, and will 
profile as many of them as space and 
resources permit. 
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4 TIMES FASTER 
THAN TODAY'S 
FASTEST 
ASSEMBLER! 


That's right. 
4 times faster. 


Clocking in at over 75,000 lines per minute 
on a 6MHz IBM AT, OPTASM is four times faster 
than Microsoft's MASM 5.0. 4 times faster — 
that’s 400% more throughput! 
But speed is only one part of it. OPTASM is 
nearly 1OO% compatible with MASM 5.0 
(except 386 support). 
It is the only single assembler capable of 
supporting the various incompatibilities 
between MASM 3, 4 & 5. That makes OPTASM 
more MASM compatible than any single 
version of MASM! 
Other features? OPTASM generates smaller 
code without ever generating extra NOP’s. It 
automatically handles jumps out of range, 
up to 15,000 symbols and most of MASM’s 
phase errors. It also boasts a built in MAKE 
and simplifies segmentation. WHAT DO PROGRAMMERS 
That’s why we can make our OPTASM SAY ABOUT OPTASM? 
challenge: Test OPTASM head to head Li Saale! Laces etiert. estes! ' 
against MICROSOFT MASM 5.0. Order both fine korhodscope Genie. 
assemblers with their 30-day guarantees. In a minutes to less than 45 
lot less than 30 days, you'll see just how daz- seconds.” 
zling OPTASM’s speed really is. You'll realize Brett Salter, President, 
a we're compatible, ease! : ts Sahn The Periscope Company 
eliver many more important features than a I 
MASM. So accept our challenge. Try both sold forna We heaee ae 
assemblers. Four times faster and more new product in 1987.” __ 
features, too. We know which one you'll Chris Dunford, Columbia, MD 
send back. 
Write or call us to order or for our detailed 
brochure. 


OPTASM: $195 Guaranteed returnable within 30 days. 


1622 N. Main Street 
Butler, PA 16001 
412-282-0864 

BBS 412-282-2799 
Telex 559215 
800-833-3061 
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All the Tools You Need 
For Motorola 680X0 
From Whitesmiths 


Whitesmiths, Ltd. now offers a complete set of 68K Cross Development Tools — 
specifically designed to work together — for the Motorola 68000 family of 
microprocessors. You get: 


A C CROSS COMPILER 

Whitesmiths’ C Compilers offer the closest conformance currently available to the draft ANSI C 
Standard. We’ve added 68020 and 68881 support, and dramatically optimized code generation, so 
you can get the code quality you need today with the language you'll need tomorrow. 

SUPPORT TOOLS 

We have all the extras you need to develop embedded programs. Our powerful object utilities 
help you link multi-segment programs, build direct and sequential libraries, create load maps and 
interspersed listings, and talk to dozens of downloaders, emulators, and PROM programmers. 


C SOURCE LEVEL DEBUGGING 


We have the support you need to debug in terms of C functions, data types, and source lines. 
You debug what you write, not a lower level language. 


A MICSIM SIMULATOR 

You can debug your embedded programs right on your development host — our 
MICSIM Simulator needs no extra hardware. It’s like debugging on your favorite 
emulator, but with no contention for dedicated resources, no download time, and 
with the symbolic breakpoint and trace control you’ve always dreamed of having. 


AN XA8 CROSS ASSEMBLER 
Our macro assembler is both fast and powerful, with support for 68020, 68881, and 68551. 


A PASCAL COMPILER 

You can program as much as you want in ISO Standard Pascal, or use the 
powerful extensions we’ve added to this production quality compiler. And 
you get complete integration with C and assembly language as well. 


Working together, the 68K Cross Development Tools deliver both 
optimized performance and improved programmer productivity. 
Best of all, Whitesmiths offers everything you need at a very com- 
petitive price. We’ve been delivering and supporting high quality 
software development tools since 1978, and we’re committed to 
continually enhancing our product line. 


If you develop 68000 programs on a DEC VAX, an IBM PC, ora 
UNIX workstation, chances are we can save you time and money. 
For more technical details, call our toll-free number today. We also 
offer attractive packages for OEMs. 


Whitesmiths, Ltd. 
59 Power Road 
Westford, MA 01886 
617/692-7800 


THE C FORUM 


by Don Libes 


The International Obfuscated 


C Code Contest 


one thing—time to present the 


I t’s April, and that could only mean 


1987 International Obfuscated C 


Code Contest winners! 


If you’ve never heard of the IOCCC, 


you are in for a real treat. The Interna- 
tional Obfuscated C Code Contest is 
run annually by Landon Noll (Amdahl 
Corp) and Larry Bassel (National 
Semiconductor) who collect C code 
that is so awful to read, it is actually 
funny. Viewed in the right light, you 
might even call it educational. The 
1987 winners are presented toward 
the end of the column. The results of 
the first, second, and third contests 
were published in Micro/Systems 
Journal in September/October 1985, 
May/June 1986, and March/April 
1987, respectively, if you want to 
track them down. (They are worth it!) 


The 1988 contest is now open. Here 


are the rules: 


Goals of the Contest: 


To write the most Obscure/Obfus- 
cated C program under the rules 
below. 

To show what should NOT be done 
in C programs. 

To provide a safe forum for poor C 
code. 


Rules: 

To help us handle the vast volume of 
entries, we ask that you follow the 
rules below. (Sorry for the length, but 
we need all the help we can get!) 


1. 


Your source must be 1536 bytes or 
less, and it must be a complete pro- 
gram, not just a subroutine. 


. To help us process your entries, we 


ask that you submit entries in the 
following format. (Please be sure to 
include the - - - lines, otherwise 
our extraction program may skip 
your entry!): 


---header items--- 

name: Your name, of course! 
org: School/Company/ 
Organization 
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e-mail address: e-mail address 
from a well known site 
postal address: Postal address, 
include your country as well 
environment: Indicate Hardware 
€ OS under which program was 
tested 

remarks: (Only item that is 
required: see below) 

---how to compile--- 

XGive command(s) needed to 
Xcompile your program. 
XFollow same rules as 

Xgiven for program below 
Xexcept that command size 
Xmust be 160 characters or 
Xless. 

---program--- 

XPlace obfuscated source of 
X1536 characters or less in 
Xthis section. Add a leading 
X"X' to each line to avoid 
Xproblems with mailers. 
XSome mailers don't like 
Xfiles with very long lines. 
XIf your entry contains lines 
longer than 80 characters 

we ask you to form con 
tinuation line sets. To 

form a coCntinuation line 
set, place a 'C' character 
at the point of a split 

and place a 'C'C (instead 

of an X) at the beginning 

of the next line. Finally, 
end the continuation line 
set as normal. 

XThe C\nC's and leading X's 
Xwill be removed prior to 
Xextraction and thus they 
Xdon't contribute toward 
Xthe source character count. 
XAll other characters are 
Xconsidered to be source. 
XNew lines count as 1 
Xcharacter. Assume a stand- 
Xard 8 character tab stop. 
---end--- 


. Regarding the header items: 


e Any text outside of the above 
format will be kept confidential. 
(The form of the header items is 
not strict.) 

e@ The “remarks” item is not op- 
tional. Please include: 
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what this program does; 
why you think the program is 
obfuscated; 
any indicate remarks you wish 
to make. 
Your entry should be written in 
common C (K&R and common 
extensions). 


. The program must be an original 


work, All programs must be in the 
public domain; copyrighted pro- 
grams will be rejected. 


. Entries must be received between 


25-Mar-88 0:00 GMT and 25-May- 
88 0:00 GMT. E-mail entries to: 


...!amdahl!obfuscate 


Amdahl talks to hplabs, decwrl, 
pyramid, seismo and cbosgd. We 
will attempt to e-mail a confirma- 
tion of receipt of contest entries, 
however, since e-mail is not reli- 
able, you may not receive it. Al- 
though, people are encouraged to 
submit entries via e-mail, one may 
mail entries to the following postal 
address: 


Landon Curt Noll 

Amdahl Corp. 

1250 E. Arques Ave., M/S 316 
P.O. Box 3470 

Sunnyvale, CA 94088-3470 
U.S.A. 


Write the words: “International Ob- 
fuscated C Code Contest” near the 
bottom left corner of the envelope. 


. Each person may submit up to five 


entries. Multiple entries must be 
sent in separate e-mail letters or 
postal envelopes. 


Announcement of Winners: 


The first announcement will be at 
the Summer ’88 Usenix BOF. 

An announcement will be posted to 
mod.announce near mid-June 1988 
stating to which newsgroup the win- 
ners have been posted. 

An article containing the winning 
entries will be published in a future 
issue of Micro/ Systems. 

Winners receive international fame 
and flames! 


Judging: 

Awards will be given to the best entry 
in a number of categories. The actual 
category list will vary, depending on 
the types of entries we received. As a 
guide, consider using the following 
categories: 


The best, small, one-line program 
The most obscure algorithm 

The strangest source layout 

The most useful obfuscated 
program 

The most creatively obfuscated 
program 
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e Anything else so strange that it de- 
serves an award 


Points to Ponder: 

People are encouraged to examine 
winners of the previous contests. A 
copy of these entries was posted to 
mod.sources on or about March 12, 
1987. 

Contact the mod.sources moderator 
if you missed that article. Keep in mind 
that rules change from year to year, so 
some winning entries may not be valid 
entries this year. What was unique and 
novel one year might be “‘old’’ the next 
year, sO use your judgment. 

We examine each entry on several 
levels of confusion. For example, each 
entry is judged when we: 


@ look at the original source 
@ run it through: 


sed -e ',“#[ ]* 
define,d' i /lib/cpp 


run it through a C beautifier 
examine the algorithm 
compile and lint it 

execute it 


One-line programs are best when 
they are short, obscure, and concise. 
We tend to dislike programs that: 


@ are very hardware specific 

@ are very OS or UNIX version spe- 
cific (index/strchr differences are 
okay, but socket/streams specific 
code is likely not to be) 

e@ dump core or have compiler warn- 
ings (it is okay only if you warn us in 
the “‘remark”’ header item) 

@ won’t compile under both BSD or 
SYSV UNIX 

@ use an excessively long compile line 
to get around the size limit 

@ simply carries an idea to excess 
without reason 

@ are similar to previous winners 

@ are similar to previous losers 


Simply abusing #defines or 
-Dfoo= bar won't go as far as a more 
well-rounded program. 

We like programs that: 


do something quasi-interesting 

pass /int without complaint 

are portable 

are unique or novel in their obfusca- 

tion style 

@ are concise 

® use size to do something interesting 
or that use size to introduce several 
different types of obfuscation 

@ make us laugh or throw up. 


Some types of programs can’t excel 
in some areas. We try to account for 
this by giving awards to programs in a 
number of areas. Of course, your pro- 
gram doesn’t have to excel in all areas, 
but doing well in a few helps. 
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Listing 1. In the category of “Best Obfuscator of Programs,” the winner is Paul 
Heckbert of Pixar. 


#include <ctype.h> 

#include <stdio.h> 

#define _ define 

#_ A putchar 

#_ B return 

#_ Cc index 

char*r,c[300001), *d=">=<=!—===| | 6&->++-->><<",*i,*1, *},*m, *k, *n, *h, *y;e,u=1,V,w, 
f=1,p,s,x;main(a,b)char**b; (p=a>1?atoi (b[1]) :79;r=ctread (0, j=l=i=c, 300000) ;v=g( 
j, &m) ; for (k=m; v!=2; j=k,m=n, v=w, k=m) {weg (k, &n) ;if (ve=1&&m-jmn166*j==35) e&6A(10), 
e=f=0;if (! f46v==346 (char*)C(j,10)<m)A(10),e-0,f=l;else if (v>2&&(u| |w) && (fj |u) && 
(1-i>1] | *i!=61) [n-k>1]] !C("-*6",*k)))continue;else if (v==3)if(f&&se+1+n-k>psse)A 
(10),e=0;else A(32),e++;else{if (f&&e+m-j>psse)A(10),e=0;e+=m-j;k=j; while (k<m)A( 
*kt++); }i=j;l=m;u=v; }e&&A(10);}g(j,m)char*j, **m; (if (j>=r) B*m=j, 2; s=isdigit (*j) 11 
*j==4666isdigit (j(1]);for(h=j;h<r;h++)if (!isalnum(*h) 6é*h!=9566 (!s]|*h!=46) 64 (! 
s||h[-1]!=10166h[(-1] !}=69] | }c("+-", *h))) break; if (h>4)B*m=h, 0;x=1; for (h=j;h<rééc( 
" \t\n", *h) sht+) ;if (n>j)h--, x=3;1f (*j==34 | | *j==39) for (h=jtl;h<rée*h!=*4 htt) if ( 
*h==92) ht++; for (y=d; *yééstrnemp(y, j,2) :y+=2) ;if (*y) hejtl-sif (!strnemp("/*",4,2)) { 
h=j+2; while (*++h!=42| |*++h!=47) ;x=4;}*m=h+1;B x;} 


Listing 2. In the category of ‘‘Most Useful Obfuscation,” the winner is Larry 
Wall of Unisys, System Development Group, Santa Monica, Calif. 


#define iv 4 

#define v ; (void 

#define XI(xi)int xifiv*’v’]; 

#define L(c,1,i)c() {d(1):m(i):)} 

#include <stdio.h> 
int*cc,c,i,ix=/\t’,exit(),X="\n’*/\d! ;XI (VI) XI (xi) extern (*vil]) 0, (* 
signal()) ();char*V,cm,D[’x’],M="\n',1I,*gets();L(MV,V, (ct=’d’,ix) )m(x) {v) 
signal (x/‘1I’,vilx));}d(x)char*x; {v)write(i,x,1i);}L(MC,V,M+tI) xv() {c>=i2m( 
c/M/M+M) : (d(&M),m(cm));}L(mi, V+cm,M) L(md,V,M)MM() (c=c*M$X;V-=cm;m (ix) ;} 
LXX() {gets (D) 1! (vifiv)) ()sc=atoi (D) ;while(c>=X) (c-=x;d("m") ; }V="ivxlcdm" 
+iv;m(1ix) ;}LV() {c-=c; while ((i=cc[*D=getchar ()])>-I)12(c?(c<i&él(-c-c, 
"$a"), 1 (i, "+%dl")) 21 (4, "(%d")) s (c&EL(M,")"),1(*D,"%O")) cml; c&E1(X,")"),1 
(-i,"%e") sm(iv-! (i6I))¢}L(m1,V,’\£")1i() {m(cm+!isatty (i=I));}ii() (m(c=cm 
=++1I)v) pipe (VI) ;ccexitcm++; for (V="jWYmDEnX"; *V;V++) xi [*V*" !J=c,xi[*Vt+) 
=C,C*=M,xi[*V*! /)=xi[*V])=c>>I;cc[-1]-=ix v)close(*VI) ;cc(M]-=M; }main () { 
(*vi) (); for (;v) write (VI[{I],V,M));:}1(xl,1x)char*1x; (v) printf (1x,x1)v) 
fflush (stdout) ;}L(xx,V+I, (c-=X/cem, ix) ) int (*vi[)) ()=({ii,11,LXxx, LV, exit,1, 
d,1,d,xv,MM,md,MC,ml,MV,xXxX,XX,XX,XX,MV,mi}; 


Listing 3. In the category of ‘“‘Best Layout,” the winner is Brian Westley of 
Starfire Consulting, St. Paul, Minn. 


char rahc 
() 


"\ns/" 


’ 
redivider 
CJ 


“Able was I ere I saw elbA" 


* 
deliver, reviled 


’ 
rahctup, putchar 


»LACEDx0 = OxDECAL, 
rof ; for 
(7 (int) (tni);) 
{int) (tni) 
~ reviled ; deliver = 
redivider 


for ((int) (tni)++,++reviled;reviled* *deliver;delivert+,++(int) (tni)) rof 
(int) -1- (tni) 
sreviled--;--deliver; 
(tni) = (int) 
- OxDECAL + LACEDx0 - 
rof ; for 
(reviled--, (int)--(tni): (int) (tni); (int)--(tni),--deliver) 
rahctup = putchar 
(reviled* *deliver) 


rahctup * putchar 
((char) * (rahc)) 


r\ 
\*/) 
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The judging will be done by Landon 
Noll and Larry Bassel. If you have any 
questions or comments, please feel 
free to send them to: ... !amdahll!- 
judges 


The 1987 winners 
First, try to understand the program 
by just reading the source and the 
judges comments. Then, try running 
the program. If you are still confused, 
try sending the source through the C 
Preprocessor, or a good C beautifier 
(unlike the BSD indent(1) program, 
which dumped core processing some 
of the entries). Should you give up, 
next month’s column will present ex- 
planations of all the programs. 

Assume entries did not pass /int un- 
less stated otherwise. 

Note that several entries had lines 
so long that they had to be broken up 
in order to fit in the magazine. 


The envelope please... 


In the category of ‘“‘Best Obfuscator 
of Programs,’’ the winner is Paul 
Heckbert of Pixar (Listing 1). . 

Judges comments: On SYSV sys- 
tems, compile with: -Dindex= strchr. 
To compile on a 16-bit machine, 
change 300000’s to 30000. Passes 
BSD lint. Try: 


ph 40 ( ph.c ) foo.c; cc foo.c -o 
ph 

ph 20 ( a_C_prog.c ) bar.c; cc 
bar.c 


Read and compile foo.c. We used this 
program to help us examine contest 
entries that caused BSD’s fold(1) pro- 
gram to choke. Thank you, Paul, I 
have added your program to our obfus- 
cated C contest tool set. 


In the category of ‘‘Most Useful Ob- 
fuscation,”’ the winner is Larry Wall of 
Unisys, System Development Group, 
Santa Monica, California (Listing 2). 

Judges comments: Join all the lines 
together except for the first five. 
Passes BSD lint. Try: 


lwall | be | lwall 
input: x*x 
input: c*2 


Also try: 


lwall | be and lwall | cat 


For a good time, try to understand 
why Larry calls the signal routine in 
this program. Larry gives some credit 
to his brother-in-law, Mark Biggar, for 
this crazy use of signals. 


In the category of “Best Layout,” the 
winner is Brian Westley of Starfire Con- 
sulting, St. Paul, Minn. (Listing 3). 

Judges comments: Putchar must 
exist in the C library and not just as a 
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macro. If it fails to compile, add the 
line: #include <stdio.h> at the top 
of the program. Passed BSD lint (prob- 
ably due to a bug in BSD lini). 

Line-by-line symmetry performed 
better than any C beautifier. Think of 
if it as a C Inkblot. 


In the category of the “Best One 
Liner,”’ the winner is David Korn of 
AT&T Bell Labs, Murray Hill, New 
Jersey (Listing 4). 

Judges comments: Passes BSD lint. 

Compile on a UNIX system, or at 
least using a -C implementation that 
fakes it. This program may not be valid 
under the proposed ANSI C standard. 
See if your can understand what is 
does before you run the program. 

Landon interviewed someone who 
claimed to be a hot C programmer. Af- 
ter reviewing this little program, the 
person cooled his reputation a bit. 

David Korn’s /bin/ksh provides us 
with a greatly improved version of the 
/bin/sh. The source for V7’s /bin/sh 
greatly inspired this contest. 


In the category of “Best Abuse of 
the Rules,” the winner is Mark Biggar, 
Unisys, System Development Group, 
Santa Monica, California: 


Pp: 


' 


Judges notes: compile with: 


cc -DC="”R)0” -DI= "if (T)0” 
-DO= "c=write(1,&c,1);” 

-DP= "main( ){x}”\ 

-DR= "read(0,&c,1)” 
-DT="c!=015” -DW= "while(C)I” 

-DX= "char c;W” markb.c 


Passes BSD lint. At least one ver- 
sion of lint is thrown into an infinite 
loop by this entry. Try: 


. | markb | od -c 


(remember to compile as 
indicated above) 


By changing the compile line, you 
can make this program do anything 
you want. This is a very efficient way 
to transfer source code, although it in- 
creases the size of Makefiles. 

With only slight variations, this pro- 
gram can be set to many uses. Con- 
sider how easy it would be to release 
UNIX source in this form. So what if 
the make files increase a bit! 

One vendor’s Jin¢ got hung in an in- 
finite loop over this entry! 


In the category of ‘Worst Style,” 
the winner is Spencer Hines of OnLine 


Write A Data Base Program 


<> 


Features 

@ screen editor and painter 

@ automatic programmer 
documentation 

@ automatic data 
pecking valid aie 

e plenty of “hooks” for 
customizing 


e@ unlimited technical support 


(end to end) 


in 10 minutes in TPascal 4.0 


an) USiNg 
QnMNe 


(formerly Turbo GhostWriter) 


Perfect for creating complex business applications! 
Ideal for BASIC programmers who find TPascal too tough! 
Spec your customer in the morning - Show a demo in the afternoon! 


More features 

@ automatic B-tree indexing 

@ consistent user interface 

@ automatic context-sensitive 
help 

e@ relational model to show 
customizing 

@ 30 day money-back gaurantee 
(less $14 shipping/handling) 


No questions to answer. Just draw your screens the way you want 
them to appear, tell Turbo Programmer how to set up the indexes 
and that’s it... Running 4.0 code in 6 seconds with no 
programming. Regular price $450. 


Now Only $289 Orders & Info 800 227-7681 
ASCII 3239 Mill Run, Raleigh, NC 27612-4135 
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8-BIT CARDS 


YOUR NETWORK'S 
THROUGHPUT? 


Here’s the solution! 


16-Bit ARC-CARD/AT™ For 
AT COMPUTERS 


16-Bit ARC-CARD/MC™ For 
PS/2™ Micro Channel™ Computers 


One of the knottiest problems 
in network configuration is 
finding the right boards to 
maximize throughput. Thomas- 
Conrad’s 16-bit cards make the 
difference. 


> Highest performance available for 
ARCNET™ LANs 


> True 16-Bit data bus interface 
> Upto 50% faster than 8-bit boards 


> Works with EGA, EMS, 3278/79 
Emulation Adapters. . .allin the 
same workstation or file server 


100% Burn-In, 2 -Year Warranty 


THOMAS-CONRAD CORPORATION 
ES SS EP ee 
Connecting to the Future 


8403 Cross Park Drive, Suite 1C, 
Austin, Texas 78754 


800-332-8683 


(In Austin, Texas, cal! 836-1935) 


ARCNET is a registered trademark of Datapoint 
Corp. PS/2 Micro Channel are trademarks of 
International Business Machines Corporation. 
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Listing 4. In the category of the “‘Best One Liner,’’ the winner is David Korn of 
AT&T Bell Labs, Murry Hill, N.J. 


main() { printf (éunix[("\021%six\012\0"}, (unix) ["have"]+"fun"-0x60) ; } 


Listing 5. In the category of ‘Worst Style,’’ the winner is Spencer Hines of 
OnLine Computer Systems, Hyattsville, Md. 


#include <stdio.h> 
#include <malloc.h> 
main (togo, toog) 
int togo; 

char *toog[]; 
{char *ogto, tgoo[80];FILE *ogot; int cogt=0, ootg, otog=79, 
ottgel;if ( togo== ottg) goto gogo; goto goog; ggot: 

af ( fgets( tgoo, otog, ogot)) goto gtgo; goto gott; 
gtot: exit(); ogtg: ++oogt; goto ogoo; togg: if. it ocotg > 0) 
goto oggt; goto ggot; ogog: if ( !ogot) goto gogo; 
goto ggto; gtto: printf( "td goto \’s\n", oogt); goto 
gtot; oggt: ae !mememp( ogto, "goto", 4)) goto otgg: 
goto gooo; gogo: exit ( ottg); tggo: ootg= strlen (tgoo); 
goto tgog: oogo: --ootg; goto togg; gooo: +togto; goto 
oogo; gott: fclose( ogot); goto gtto; otgg: ogto= ogto +3; 
goto ogtg; tgog: ootg-=4; goto togg;: gtgo: ogto= tgoo; 
goto tggo; ogoo: ootg-=3; goto gooo; goog: ogot= fopen( 
toog{ ottg], "“r"); goto ogog; ggto: ogto= tgoo; goto 
ggot;} 


Listing 6. And for the grand prize of ‘‘Most Well Rounded Confusion,”’ the 
winner is Roemer B. Lievaart of VU Infomatica, Amsterdam, The Netherlands. 


#define D define 
Y return 
R for 
e while 
I printf 
1 int 
C y=v+111;H(x,v) *y++= *x 
H(a,b)R(a=bt11;a<b+89;a++) 
s(a)t=scanf ("$d", &a) 
1 V[1100}],u,r(J={-1,-11,-10,-9,1,11,10,9},h[{}={11,18,81,88),in(]=(22,27,72, 17)5 
bz, 1lv=60,*x, *y,m,t;S(d,v,f,a,b)1*v; {1 c=0, *n=v+100, bw=d<u- 12a:-9000,w,z,i,zb,q= 
3-£;4£ (d>u) (R(wei=0;i<4;it+) wt=(m=v (h(i) ])==£2300:m==q?-300: (t=v[in[i]])==£2-50 
rt\e—q?50:0;return w;)}H(z,0) {if(G2(v,z,£,100)) {ct+;w= -S(d+1,n,q,-b,-bw) ;if (w>bw 
) (zb=z;bwew; if (w>=b] |w>=8003)Y w;}})if(!c) {bz=0;C;Y- S(d+1,n,q,-b,~-bw) ; }bz=zb;Y 
d>=u-12bwt (c<<3) : bw; }main() {R(;t<1100;t+=100)R (m=0;m<100;m++) V[t+m] =m<11] |m>88s 
11] (+1) ¥10<223:0;V[44]) =V[55]=1:V[45]=V[54]=2; I("Level:") ;s(u) ze(1v>0) (do{I("Yo\ 
u:"):s(m);}e(!G2(V,m, 2, 0) &&m!=99) ; if (m!=99) lv--;if (1lv<15é6u<10) ut+=2; I("wWait\n") 
1 (Value: %d\n",S (0,V,1,-9000, 9000) ) ;I("move: d\n", (lv-=GZ(V,bz,1,0),bz)):}}GZ 
(v,2,£,0) 1*v; {1*3,q=3-f£,g=0,i,h, *k=v+z;if (*k==0)R(i=7;1>=0; i--) (j=k+(h=r{i]);e( 


*4m—q) jtehsif (*j—=£66j-h!=<k) (if (1g) (g=1:C; e(jl=k) *((jJ-=#h) to)=f£73)¥ ge} 


Computer Systems, Hyattsville, Mary- 
land (Listing 5). 
Judges comments: Try: 


avalon avalon.c 


Specifically designed to maximize the 
bother function for structured program- 
mers, this program takes goto state- 
ments to their logical conclusion. The 
layout and choice of names are classic. 

We consider this to be a beautiful 
counter-example of Frank Rubin’s let- 
ter to ACM form titled: “ “GOTO Con- 
sidered Harmful’ Considered Harm- 
ful’ (see Communications of the 
ACM, March 1987, Page 195-196). 


The grand prize, “Most Well-Rounded 
Confusion,” is awarded to Roemer B. 
Lievaart of VU Informatica, Amsterdam, 
The Netherlands (Listing 6). 

Sample session (user input sur- 
rounded by angle brackets ““<” and 
SS): 


Level:(2) (value from 0 to 10) 
You:(34) (value from 11 to 88) 


Wait 
Value:-16 
move: 33 
You: (43) 
Wait 
Value:-32 
move:35 
You: (36) 
Wait 
Value: 16 
move:64 
You: (65) 
Wait 
Value:0 
move: 37 


Continue as needed. If you get stuck, 
try 99. 

This program is confusing in what it 
looks like, what it does, and how it 
does it. This is yet another winner 
from The Netherlands! O 


Don Libes is a computer scientist 
working on artificial intelligence in 
robot control systems in the Washing- 
ton, D.C. area. 
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THE BEST OF BOTH WORLDS 


Developing an application used to be easy — all you 
had to do was program it. But today, with countless lan- 
guages, compilers, libraries, databases, editors, debuggers, 
and other tools, it is choosing the right development soft- 
ware that creates the real problem. 

Now The Andsor Collection introduces a unique solu- 
tion: a collection of sophisticated development tools, which 
you can use on their own, or together with your old ones. 

The Andsor Collection is, of course, the superb 
application development system that programmers, VARs, 
and other developers have been using for over two years. 
And starting with Version 2.2, The Andsor Collection has 
acquired a new dimension: now you can access all its func- 
tions from within another program! 

Think of it as a comprehensive, universal, language 


independent library. But The »~—— eee 


Andsor Collection is not a 
collection of subroutines: it is 
a seamless, integrated, inter- 
active environment, specif- 
ically designed to expedite 
application development. 
Whether you use C, 
Pascal, Cobol, Fortran, Basic, 
or any other language, The 
Andsor Collection can en- 
hance your applications dra- 
matically. Whether you add 
functions to an old program, 
or you write a new one, you 
can make them faster, more 


efficient, and more appealing: 


Use The Andsor Collec- 
tion to implement an entire 
application, or just portions of | 
an application. You can, for 
example, create a windowed 
environment, add attractive 
data entry functions, define 
indexed data file structures, 
produce sophisticated reports 


or forms, and so on. Ll 


Although The Andsor Collection has far more features 
than other development systems, it is only one tenth their 
size. So the entire system can stay in memory, keeping all 
functions instantly accessible. 

And The Andsor Collection is famous for its unique 
interactive environment. There is no conversion or transla- 
tion — modify a procedure, a file definition or relation, a 
data entry screen, or anything else, and the change takes 


effect immediately, even while the application is running! 


Application development is a new experience. 

The application users will benefit too. The Andsor 
Collection is amazingly fast, and since all data is in vari- 
able length format, the files take a fraction of the space 
needed with other systems. So not only will you develop 
sous gpplicaons sooner, but they will be more efficient 

: ———, too. Whether you use The An- 

dsor Collection alone, or to 
cle a program. 

t the best of both 
wate. rder The Andsor 
Collection today, and discover 

| a whole new environment, 
without giving up your old 
development tools or your ex- 
isting applications. Moreover, 

| The Andsor Collection will be 
useful with all your future ap- 
plications and languages. 

You won’t find a better 

| value in development soft- 
ware: one program that is 

~ | both a powerful stand-alone 

| application development sys- 

| tem, and a unique language 
independent collection of soft- 
ware tools; plus the run-time 
interpreter with unlimited 
royalty-free distribution. All 
for an incredibl; a price. 

| And with our | 

lee ceoarie io have lit- 
tle to and a lot to gain. 


“We looked at several systems and de- 
cided to standardize on The Andsor Col- 
lection. We are using it in many applica- 
tions in several departments.” 

Gordon Eyers, Director of In- 


“With The Andsor Collection we have 
achieved faster development and more 
efficient applications, which is important 
in large and complex projects like our 
Court Management System.” 


“The Andsor Collection is unequalled 
stitial oe ave knnieipontes ae 


formation Services, pate Ce Utilities 
Commission, Brantford, Ontario 


ANDSOR RESEARCH INC. 
390 Bay Street, Suite 2000 
Toronto, Ontario MSH 2Y2 
(416) 245-8073 


Dr. Mark Schrager, Consultant, 


Municipal Computer Services, 
Rochester, New York 


To order call toll free 
(U.S. and Canada) 


1-800-628-2828 
Ext. 535 


*Price includes shipping in the U.S. and Canada. Please add $10 for shipping 
to other countries. If you return the software, $8 will be deducted from the re- 


fund, to cover our shipping cost. 


System requirements: any IBM PC or PS/2 or fully compatible, 250K + (e 
programs), one disk drive or hard disk, monochrome or color monitor, 


excluding DOS and other 
S 2.0+ or OS/2 


rise Andsor Research Inc. Andsor is a registered trademark and The Andsor pCofecton is a trademark of Andsor Research Inc 


is a registered trademark and IBM PC, PS/2, OS/2 are trademarks of IBM Corporati 


Joe Blask, Engineering Support, 
General Motors, Troy, Michigan 


She Andsor Collec 
> 1 45 (includes shipping*) 


Visa, MC, AmEx, Check 


UNLEASH YOUR 80386! 


Your 80386-based PC should runtwoto 
three times as fast as your old AT. This 
speed-up is primarily due to the doubl- 
ing of the clock speed from 8 to 16 MHz. 
The new MicroWay products discussed 
below take advantage of the real power 
of your 80386, which is actually 4 to 16 
times that of the old AT! These new pro- 
ducts take advantage of the 32 bit regis- 
ters and data bus of the 80386 and the 
Weitek 1167 numeric coprocessor chip 
set. They include a family of MicroWay 


80386 compilers that run in protected 
mode and numeric coprocessor cards 
that utilize the Weitek technology. 

The benefits of our new technol- 
ogies include: 
e An increase in addressable memory 
from 640K to 4 gigabytes using MS- 
DOS or Unix. 
¢ A 12 foldincrease in the speed of 32 bit 
integer arithmetic. 
¢ A 4 to 16 fold increase in floating point 


WEITER 


mW1167 Numeric 
Coprocessor Board 


MicroWay 80386 Compilers 


NDP Fortran-386 and NDP C-386 are globally 
optimizing 80386 native code compilers that 
support a number of Numeric Data Processors, 
including the 80287, 80387 and mW1 167. They 
generate mainframe quality optimized code and 
are syntactically and operationally compatible to 
the Berkeley 4.2 Unix {77 and PCC compilers. 
MS-DOS specific extensions have been added 
where necessary to make it easy to port pro- 
grams written with Microsoft C or Fortran and 
R/M Fortran. 

The compilers are presently available in two 
formats: Microport Unix 5.3 or MS-DOS as ex- 
tended by the Phar Lap Tools. MicroWay will port 
them to other 80386 operating systems such as 
OS/2 as the need arises and as 80386 versions 
become available. 

The key to addressing more than 640 kbytes 
is the use of 32-bit integers to address arrays. 
NDP Fortran-386 generates 32-bit code which 
executes 3 to 8 times faster than the current 
generation of 16-bit compilers. There are three 
elements each of which contributes a factor of 2 
to this speed increase: very efficient use of 
80386 registers to store 32-bit entities, the use of 
inline 32-bit arithmetic instead of library calls, 
and a doubling in the effective utilization of the 
system data bus. 

Anexample of the benefit of excellent codeisa 
32-bit matrix multiply. In this benchmark an NDP 
Fortran-386 program is run against the same 
program compiled with a 16-bit Fortran. Both 
programs were run on the same 80386 system. 
However, the 32-bit code ran 7.5 times faster 
than the 16-bit code, and 58.5 times faster than 
the 16-bit code executing on an IBM PC. 

NDP FORTRAN-386™ 
NDP C-386™ 


Micro 
Way 


MicroWay Numerics 


The mW1167™ is a MicroWay designed high 
speed numeric coprocessor that works with the 
80386. It plugs into a 121 pin “Weitek” socket 
thatis actually a super set of the 80387. This soc- 
ket is available on a number of motherboards 
and accelerators including the AT&T 6386, 
Tandy 4000, Compaq 386/20, Hewlett Packard 
RS/20 and MicroWay Number Smasher 386. It 
combines the 64-bit Weitek 1163/64 floating 
point multiplier/adder with a Weitek/Intel de- 
signed “glue chip”. The mW1167™ runs at 3.6 
MegaWhetstones (compiled with NDP Fortran- 
386) which is a factor of 16 faster than an AT and 
2 to 4 times faster than an 80387. 

mW1167 16 MHz 

mW1167 20 MHz 


Monoputer™ - The INUOS T800-20 Trans- 
puter is a 32-bit computer on a chip that features 
a built-in floating point coprocessor. The T800 
can be used to build arbitrarily large parallel pro- 
cessing machines. The Monoputer comes with 
either the 20 MHz T800 or the T414 (a T800 
without the NDP) and includes 2 megabytes of 
processor memory. Transputer language sup- 
port from MicroWay includes Occam, C, Fortran, 
Pascal and Prolog. 

Monoputer 1414-20 with 2 meg’ ...$1495 
Monoputer T800-20 with 2 meg’ ...$1995 


Quadputer™ can be purchased with 2, 3 or 4 
transputers each of which has 1 or 4 megabytes 
of memory. Quadputers can be cabled together 
to build arbitrarily fast parallel processing 
systems that are as fast or faster than today’s 
mainframes. A single T800 is as fast as an 
80386/mW1 167 combination! 

Biputer™ T800/T41 4 with 2 meg’... .$3495 
Quadputer 4 T414-20 with 4 meg' ...$6000 


‘Includes Occam 


speed over the 80387/80287 numeric 
coprocessors. 

Equally important, whichever Micro- 
Way product you choose, you can be 
assured of the same excellent pre- and 
post-sales support that has made Micro- 
Way the world leader in PC numerics 
and high performance PC upgrades. 
For more information, please call the 
Technical Support Department at 

617-746-7341 
After July 1988 call 508-746-7341 


MicroWay * 
80386 Support 


80386 Multi-User Solutions 


AT8™ - This intelligent serial controller series is 
designed to handle 4 to 16 users in a Xenix or 
Unix environment with as little as 3% degrada- 
tion in speed. It has been tested and approved by 
Compag, Intel, NCR, Zenith, and the Department 
of Defense for use in high performance 80286 
and 80386 Xenix or Unix based multi-user 


Phar Lap™ created the first tools that make it 
possible to develop 80386 applications which 
run under MS-DOS yet take advantage of the full 
power of the 80386. These include an 80386 
monitor/loader that runs the 80386 in protected 
linear address mode, an assembler, linker and 
debugger. These tools are required for the MS- 
DOS version of the MicroWay NDP Compilers. 
Phar Lap Tools 


PC/AT ACCELERATORS 
287Turbo-10 10 MHz 
287Turbo-12 12 MHz 
287TurboPlus-12 12 MHz 
FASTCACHE-286 9 MHz 
FASTCACHE-286 12 MHz 
SUPERCACHE-286 


MATH COPROCESSORS 
80387-20 20 MHz 

80387-16 16 MHz 

80287-10 10 MHz 

80287-8 8 MHz 

80287-6 6 MHz 


8087 5 MHz 


The World Leader in PC Numerics 

P.O. Box 79, Kingston, Mass. 02364 USA (617) 746-7341 
32 High St., Kingston-Upon-Thames, U.K., 01-541-5466 
St. Leonards, NSW, Australia 02-439-8400 


TURBO PASCAL CORNER 


by Stephen R. Davis 


Virtual Memory Techniques: 
Part 2— Pointer Functions 


Memory Managers (see Micro/ 

Systems, March 1988), I com- 
pared arrays of arrays with arrays of 
pointers to arrays. I demonstrated 
how they are similar in use, and how 
arrays of pointers to arrays are flexi- 
ble. This time, I will investigate the 
topic further. But first I want to clarify 
a few things and discuss some new 
Turbo Pascal products. 


iE the initial discussion of Virtual 


Exaggeration 

My November/December 1987 col- 
umn, “‘VAR Variables,’ was devoted to 
the passing of arrays to procedures, 
both as VAR and as non-VAR variables. 
Micro/Systems Journal readers were 
not asleep, and a few of them chal- 
lenged the assertions I made in that 
column. 

Some readers questioned my claim 
that ‘the Turbo manual implies that 
array variables are always passed by 
reference.” These readers pointed out 
that the Version 3.0 manual emphati- 
cally states this on page 224. Yes, but 
it is nonetheless incorrect, at least for 
Version 3.01A of the Turbo compiler. 
A detailed examination of the assembly 
language code generated by Turbo re- 
veals that arrays not declared as VAR 
parameters are pushed in their en- 
tirety onto the called program’s stack 
by a library routine called explicitly for 
that purpose. 

Another reader, J. C. Blanford of 
Dothan, Alabama, reacted to my con- 
cluding remark: “‘if performance 
means anything ... use VAR vari- 
ables.” Blanford’s timing program con- 
tained two procedures, Change and 
VChange, both of which accessed a 
large array, one as a ‘“‘normal” and one 
as a VAR parameter. The main timing 
loop was designed to call either one or 
the other of these two routines. By 
editing the call and rerunning the pro- 
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gram, the user could quickly compare 
the timing of the two otherwise identi- 
cal procedures. 

When I executed Blanford’s exam- 
ple program passing an array of 1,000 
integers, I found, to my chagrin, virtu- 
ally identical timings for Change and 
VChange! I repeated my earlier tests 
and they showed that VAR parameters 
were significantly faster. After some 
reflection (and a peek at the assembly 
language code involved), I realized that 
my earlier claim had been slightly ex- 
aggerated. The problem is that pass- 
ing an array as a “normal’’ parameter 
means the entire array must be copied 
onto the stack. Although Turbo does 
this using a comparatively fast block- 
move machine instruction, this is still 
time consuming. Having copied the en- 
tire. array, however, subsequent ac- 
cesses are somewhat faster than VAR 
parameter accesses, since the seg- 
ment register is not reloaded with 
each access and the 
instructions are 


larger only heightens the effect. When 
the size of A/ /is increased to 10,000, 
the ratio is closer to 1,000 times. 

However, if the called procedure ac- 
cesses each element of A/ / more than 
once, the penalty paid in copying the 
array onto the stack is compensated 
for by the slower accesses. When 
Change and VChange are modified to 
access each element of A/ / some 100 
times, the ‘‘normal’’ Change proce- 
dure actually finishes some 20 percent 
faster than VChange. 

Therefore, if each element of an ar- 
ray is to be accessed by a procedure 
more than once, it may actually prove 
faster to pass the array normally 
rather than as a VAR variable. There is 
a third possibility: refer to the array 
globally rather than passing it as a pa- 
rameter. Although this method is aes- 
thetically less pleasing, it suffers nei- 
ther from the copy penalty nor from 
the slower accesses and proves 
slightly faster than either of the other 
methods. 


Turbo Products 

Several new Turbo Pascal products 
have appeared since my last column 
(MS/J, March 1988). The Turbo Power 
people are at it again, this time intro- 
ducing a set of utilities to make bridg- 
ing the gap between Turbo 3.0 and 4.0 
easier. One of these is an Overlay 
Manager that restores to 4.0 an over- 
lay capability similar to that found in 
3.0. Anyone porting overlayed 3.0 
code to the new Turbo standard should 


slightly faster. Both 
Change and 
VChange access 
each element of the 
array once. Conse- 
quently, the penalty 
paid for copying the 
array to the stack is 
made up by the 
faster access time. 
When I modified 
Change and 
VChange so that 
only 10 of the 1,000 
elements of the ar- 
ray Af] are ac- 
cessed, the results 
were different. 
Here, VChange is 
approximately 100 
times faster than 
Change. This 
mimics the tests 
that I had per- 
formed, which ac- 
cessed represen- 
tative elements 
from the array. 
Making the array 


Listing 1. Returning the address of a record for 
Turbo Pascal 4.0 


{ Simplistic Function Pdata does nothing more than return 
address of Index’th record of an array of records. Main 
program uses Pdata first to initialize array and then 
demonstrates that program is working as designed.} 


Type 
data = record 
contents: array [0..9] of integer 
end; 
ptr = “data; 


Var 
mdata ; array [0..9] of data; 
i,j: integer; 


Function Pdata (index : 
begin 

Pdata := ptr(@mdata [index]) 
end; 


integer) : ptr; 


begin 
{ Initialize array of records 
to known values } 
for i := 0 to 9 do 
for j := 0 to 9 do 
pdata(i)*.contents[j] := i * j; 


{ Now print out a few representative values 
both conventionally and using Pdata for 
comparison } 

for i := 0 to 9 do 

writeln (‘i= ', i, 
: mdata(i].contents[i] =’, 
mdata[i].contents[i]:3, 
. pdata(i)*.contents[i] =’, 
pdata(i)*.contents[i] :3) 
end. 
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give them a call. 

Turbo Power has also been showing 
off a late beta version of TDebug de- 
signed for Turbo 4.0. This really dyna- 
mite debugger is an extension of the 
company’s TDebug-Plus for 3.0. Any- 
one comfortable with that debugger 
will feel right at home with this 4.0 
version. The windows are snappy and 
attractive and the interface is natural 
and powerful. Added to this version is 
a Codeview-like assembly language 
mode that intermixes Pascal and the 
resulting assembly language state- 


ments—very educational. Also added 
are improved video support and key- 
board macros for commands that are 
often repeated. Bugs just don’t have a 
chance with this package. 

I also received is a very nice share- 
ware debugging aid from Paradigm 
systems, TPCV. This program allows 
TP 4.0 programs to be debugged with 
the Microsoft Codeview debugger. 

Codeview is Microsoft’s flagship 
debugger, which is distributed with 
their MS-DOS compilers and assembler. 
Probably more for marketing than 


If You Have Turbo C You Have 


Half Your C-Programming Vehicle 


Turbo C is a great compiler but there is 
one vital cog missing — debugging. 
Without it, you have to spend an awful 
lot of energy to go a short distance. 


Gimpel Software’s C-terp, long recog- 
nized as the leading C interpreter, now 
fully supports Turbo C with com- 
plete compatibility guaranteed. 


Interactive Debugger — Our 
debugging facilities include split 
screen (code in upper portion, 
dialog in lower), breakpoints 
(sticky, temporary, line/function, cursor- 
directed), display of structures and arrays, 
execution of any expression (even those 
involving macros), function traceback 
with arguments, watch expressions and 
watch conditions (watchpoints). Our 
watch expressions can be structs or 
arrays. We catch out-of-bounds pointers! 


No Toy — Full K&R with ANSI enhance- 
ments. Multiple-module with a built-in 
automatic make. It has virtual memory 
option (with optional direct use of ex- 
tended memory) and a shared symbol 
option for those big programs. It supports 
graphics, dual displays and the EGA 
43-line mode. 


Links to external libraries — (both code 
and data, automatically) which can call 
back to interpreted functions. Function 
pointers are compiler compatible. 


100% Turbo-C compatible. — Same 
header (.h) files, data alignment, bit field 
orderings and preprocessor variables as 
your compiler. We link in your com- 
piler’s library. 


Our reconfigurable editor —is multifile 


and comes with a configuration script to 
mimic Turbo’s editor. 
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The missing wheel that will 
turn your half-cycle into a bicycle 


C-terp 


Order C-terp today! 
Call (215) 584-4261 


Introductory Price for Turbo C-terp: 
$139.00 


VISA, MC, COD —30 day money back 
guarantee 


C-terp Version 3.0 is also available for the 
following compilers: 

Microsoft, Lattice, Aztec, C86, and Mark 
Williams ($298) and Xenix ($498). 


sPEL SOFTWARE 


3207 Hogarth Lane 
Collegeville, PA 19426 


C-terp is a trademark of Gimpel Software, and Turbo.C of 
Borland International. 


technical reasons, Codeview accepts its 
symbol information directly from the 
.EXE file rather than from the load map. 
Turbo Pascal does not include this in- 
formation in the .EXE file it generates. 
TPCV takes the public symbols from the 
load map generated by Turbo Pascal’s 
TPMAP and places them into the .EXE 
file in Codeview format! 

To use TPCV, simply compile with 
the detail load map option turned on, 
generate a load map with TPMAP, run 
TPCV, and then execute Codeview on 
the program. All of the Codeview com- 
mands are available for use. Local sym- 
bols are not available, since these do 
not appear in the load map, but all pub- 
lic variables and procedure names, and 
most line numbers are available. Sur- 
prisingly, Codeview did not appear to 
have any problem with Turbo Pascal 
units. There may be a few small 
glitches, however, since Codeview was 
not designed for Turbo Pascal 


Today’s Topic— 

Pointer Functions 

In quest of a virtual memory manager 
(VMM) for Turbo Pascal programs, 
last time we examined how it is often 
simpler and faster to handle a large 
matrix as an array of pointers to arrays 
rather than simply an array of arrays. 
The syntax resembled: 


Type 
example = array [1..10] 
of integer; 
exptr = “example; 

Var 
mdata : array [1..10] of 
example; {array of arrays} 
pdata : array [1..10] of 
exptr; {array of “arrays} 


Individual integers are referenced as: 
mdata[i][j] :=... 
pdata[i]*[j] :=... 

It is just as simple to envision an array 

of pointers to records, the syntax of 


the declaration appearing: 


Type 
example = record 


idata : array [1..10] of 
integer; 

cdata : array [1..10] of 
character 


end; 
exptr = “example; 


Var 
mdata : array [1..10] of 
example; 
pdata : array [1..10] of 
exptr; 
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with references appearing as: 


mdata[i].idata[j] := ... 
pdata[i]*.idata[j] := ... 


The Plot Thickens 

If pdata were a function that returned 
the address of an array of arrays or 
records, its use under Turbo 4.0 would 
be similar to that above: 


pdata(i)*[j] SiS avers 
for an array} 
pdata(i)*.idata[j] := ... 
for a structure} 


Notice the round braces following 
pdata since this is a function call. Also 
notice that the function call appears on 
the left side of the equal sign. This 
causes no problems because it is not 
the value returned by the function that 
is the target at the equal sign, but 
rather the memory location to which 
that value points. 

The program shown in Listing lisa 
simple example of such a function. 
The variable mdata is an array of 
records of type data. The function 
pdata accepts a simple integer 
index and returns a pointer to the 
“index’th”’ record in mdata (thus, 
pdata(i)* becomes functionally equiv- 
alent to mdata/i)). The first part of the 
program uses pdata on the left hand 
side of the equal sign to initialize the 
array of records to some known value. 
The second part prints out some rep- 
resentative values. By comparing 
mdata[i]to pdata(i)*, we are reason- 
ably certain that our program is work- 
ing as expected. 

This gives us the mechanism we 
need to implement our VMM in Turbo 
4.0. We break up our huge data struc- 
ture into manageably sized records, 
each referenced by an index like an ar- 
ray. The user-program accesses these 
blocks by invoking the VMM function, 
which returns the location of that 
block in memory. If the block is not 
currently in memory, the VMM can 
load it from disk and return it to the 
address where it was loaded. The user 
program treats this like a reference to 
a simple matrix or array of structures. 

Note, however, that 3.0 only ac- 
cepts a variable name in front of the 
indirection carat. Therefore, to exe- 
cute the program listed under 3.0, 
replace 


pdata(i)*.contents[j] 
with 


temp := pdata(i); 
temp*.contents[j]; 
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where temp has been declared to be of 
type ptr. Also replace the expression 
ptr(@mdatal[index]) with addr- 
(mdata[index]). 


Conclusion 

Now we have the tool we need to im- 
plement our Virtual Memory Man- 
ager—the function which returns a 
pointer to either a record or a simple 
array. In my next column, I will discuss 
how such a function keeps track of 
these records. im 


Stephen Randy Davis is technical 
editor for Micro/Systems, and a pro- 


grammer for a defense contractor in 
Greenville, Texas. 


Product Information 


Turbo Power Software 
3109 Scotts Valley Dr., Ste. 122 
Scotts Valley, CA 95066 


(408) 438-8608 


Paradigm Systems 
P. O. Box 152 
Milford, MA 01757 
(617) 543-3609 


TASKVIEW 


ROCK SOLID 
MULTITASKING! 


Packed with the power you need, TASKVIEW takes you beyond 


the limits of DOS. 


® Communicate while you edit 

= Compile while you print 

= Load up to 5 megabytes of programs 

= Manage resident utilities 

# Time-slice multiple jobs 

= Cut & paste between programs 
TASKVIEW lets you load up to 10 of your favorite applications and 
switch between them at a keystroke. They can even continue to 
run while you work on something else! TASKVIEW is the BEST 


multitasker you can buy. Just ask our customers. 


“Thanks for a wonderful product!”’ 


“*TASKVIEW is the only multitasker | own which runs efficiently & 
correctly both on my Zenith Z-151...and on my Orchid 286e. . . 1 
also have DoubleDOS, DESQview, TopView, Windows, and Concur- 


rent PC-DOS”’. 


‘‘Fantastic! What DoubleDOS, MS-Windows, and all the other ‘stuff’ 


should have been!”’ 


“My BBS is now up 24 hours, 7 days a week thanks to TASKVIEW.”’ 


‘‘Thanks! I needed that!’’ 


TASKVIEW requires an IBM PC, XT, AT or Jr compatible, and PC 
or MS DOS 2.x to 3.x. To get your copy, call toll free: 

(800) 367-0651 
or send $79.95 + $3.00 S&H ($8.00 Intl.) to: 


e 
@ Sunny Hill Software 
PO Box 55278, Seattle, WA 98155-5278 


For more information call (206) 367-0650 


DoubleDOS trademark Softlogic Solutions, Concurrent PC-DOS reg. trademark Digital Research Corp.. MS Windows 
trademark Microsoft Corp., DESQview trademark Quarterdeck Office Systems. Inc. TopView trademark IBM Corp 
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Assistance in 
Debugging C 


Programs 


ne 


by Bill Rogers 


S P O t Pro Fe ram hen debugging, a common technique used by C 


programmers is to add printf statements to a 
‘ . function being debugged. These printf state- 
bu o S USIN 2 printf ments assist in analyzing flow and in spotting variables as- 
suming incorrect values. Since this practice is so common, a 
formal approach to adding these debugging statements and to 
S t a t emen t S and printing or displaying the results can reduce the program- 
ming time and also the debugging time. The approach illus- 
trated here offers a debugging tool as outlined in the header 
1 ssue a d e b U g Sin g DEBUG.H (Listing 1), the program DEBUG.C (Listing 2), and 
the support program BASEPTR.ASM (Listing 3). When prop- 
erly used, these functions cover flow analysis, function input 
° parameters display, function output parameters display, and 
rep ort t O a prum t er function return value display. Intermediate results may also 
be displayed. (The debugging report may be directed to a 
file rather than the screen so that the report does not inter- 

Or fil e, fere with normal screen input and output.) 
The debugging package contains the following functions: 


Function Description 

DBUGBEGN _ Function entry 

DBUGBIN Print int in binary 

DBUGBOOL Print boolean value (i.e., int that is 0 or 1) 
DBUGCHAR Print character value 

DBUGDBL Print double value 

DBUGEND Function exit 

DBUGFLOT Print float value 

DBUGHEX Print int value in hex 

DBUGINT Print int value 
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DBUGLONG Print long value 

DBUGOPEN © Open debug report file 
and get environment 
variables 

DBUGPTR Print a pointer value— 
segment, offset & 
absolute 

DBUGSTAK Print the stack 

DBUGSTR Print a string value 


The function calling sequences 
are as follows: 


DBUGOPEN(); 


DBUGBEGN( FUNC ,SCCSID); 
FUNC function name, string 
SCCSID file name & version, string 


DBUGEND( FUNC); 
FUNC function name, string 


DBUGSTAK( FUNC , NUM) ; 
FUNC function name, string 
NUM number of stack words, integer 


DBUGxxxx( FUNC, VARNAME, VARVAL) ; 
FUNC function name, string 
VARNAME variable name, string 
VARVAL variable value, appropriate 
variable type matching xxxx 
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Table 1. Debug Flags. 


C External 
Variable Value 
0 or 1 Gif 1 output 


Environment 
Value 
TRUE or FALSE 


Debug 
Flag 
DBUGFLGO 
to 
““stderr’’) 
DBUGFLG1 
DBUGFLG2 
DBUGFLG3 
DBUGFLG4 
DBUGFLG5 
DBUGFLG6 
DBUGFLG7 
DBUGFLG8 


Oorl 
Oorl 
Oorl 
Oorl 
Oorl 
Oorl 
Oorl 
Oorl 


TRUE or FALSE 
TRUE or FALSE 
TRUE or FALSE 
TRUE or FALSE 
TRUE or FALSE 
TRUE or FALSE 
TRUE or FALSE 
TRUE or FALSE 


Conditional compilation is controlled by a preprocessor 
variable (i.e., DEBUG_1). Conditional output is controlled by 
the environment debug flags (and C external variables with 
the same name) given in Table 1. 

The debug flags may also be set from a file by replacing 
the preprocessor variable ENVFLAG with FILEFLAG and re- 
compiling the file DEBUG.C. 


At least one debug call 
must be made to set the 
debug flags and open the 
debug output file... A 
convenient way of setting 
a debug call is to have 
DBUGOPEN as the first 
debugging statement in a 
program. 


At least one debug call must be made to set the debug 
flags and open the debug output file. Otherwise no debug- 
ging output will appear. A convenient way of setting a debug 
call is to have the call DBUGOPEN as the first debugging 
statement in a program. 

The approach to adding debugging statements by means 
of a predefined scheme carries the following benefits: 


. Adding debugging statements takes less time; 

. Fewer errors are made by introducing the debugging 
statements; 

. The output report is in a uniform format; 

. The mechanism for conditional compilation and condi- 
tional debugging output is well defined; 

. Displaying pointers, which can become a little involved, 
are already defined; 

. Displaying stack snapshots, which can be more than an 
little involved, are already defined; and 

. A production version of a program can be produced 
without deleting any code. 


“ for) ao & O Nr 
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Listing 1. DEBUG.H file; debug definitions 


#ifndef debug 
#define debug 


EXTERNAL int DBUGOPFL 
#ifdef INTRINIT 

=0 
#fendif 
EXTERNAL int DBUGFLGO 
tifdef INTRINIT 

=0 
#endif 
EXTERNAL int DBUGFLG1 
tifdef INTRINIT 

=0 
#endif 
EXTERNAL int DBUGFLG2 
#ifdef INTRINIT 

=0 
#endif 
EXTERNAL int DBUGFLG3 
#tifdef INTRINIT 

=0 
#tendif 
EXTERNAL int DBUGFLG4 
#ifdef INTRINIT 

=0 
fendif 
EXTERNAL int DBUGFLG5S 
#ifdef INTRINIT 

= 0 
#endif 
EXTERNAL int DBUGFLG6 
#ifdef INTRINIT 

=0 
#fendif 
EXTERNAL int DBUGFLG7 
#ifdef INTRINIT 

= 0 
#endif 
EXTERNAL int DBUGFLG8 
#ifdef INTRINIT 

= 0 
#endif 
EXTERNAL FILE *DBUGHNDL; 


extern void DBUGBEGN () ; 
extern void DBUGBIN(); 
extern void DBUGBOOL (); 
extern void DBUGCHAR () ; 
extern void DBUGDBL(); 
extern void DBUGEND(); 
extern void DBUGFLOT (); 
extern void DBUGHEX(); 
extern void DBUGINT(); 
extern void DBUGLONG(); 
extern void DBUGOPEN(); 
extern void DBUGPTR(); 
extern void DBUGSTAK (); 
extern void DBUGSTR(); 
extern unsigned short int STACKPTR(); 


#tendif 


Listing 2. DEBUG.C file; Debugging functions 


* GENERAL DESCRIPTION: 

* Debug flags are defined in header "debug.h". 

* Debug flag values may be specified either in 

* environment or in a file depending upon #define below. 
* If set in environment: 

* DBUGFLGn=FALSE 

= DBUGFLGn=TRUE 

* for n= 0,..8. 
* 

* 

* 

* 

* 

* 

* 


If environment variable does not exist, then 
corresponding flag value is set to false. 
If set in a file, in the first record give the string: 
abcdefghi 
a=0 for DBUGFLGO=FALSE or a=1 for DBUGFLGO=TRUE 


“400 for DBUGFLG8=FALSE or h=1 for DBUGFLG8=TRUE 
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If flag does not exist or value is not 1, then local void NEWTIME(P CURDATE,P_CURTIME) 
corresponding flag value is set to false. If file does string P_CURDATE[]; /* out */ 
not exist, then all flag values are set to false. string P_CURTIME[]; /* out */ 
At least one debug flag, DBUGFLG1 thru DBUGFLG8, must 
be true for a debug output file to be produced. /* Get date in form "yyyy mmm dd www" and time in form 
DBUGFLGO has follwing definition: hh:mm:ss" from SYSTIME, string returned by “asctime". */ 
= FALSE output is directed to disk file DEBUG.LST 
= TRUE output is directed to stderr. static string FUNC[] = "NEWTIME"; 
SCCS IDENTIFICATION */ static string D(20 +1) =" 
static char SCCSID[] = "@(#)debug.c 5.3.8"; static string T(20 +1) =" 
static string SYSTIME[30+1]; 
SPECIAL DEFINE */ static string DUMMY [3+1] ; 
#define metachar int 
#define void int begin */ 
#define string char st repy (SYSTIME, asctime (localtime (NULL) }); 
#define public strncpy(éD[ 0], &SYSTIME(20],4); /*  "yyyy" 
#define local static strncpy(&D[ 4],&SYSTIME[ 3],8}); /* ™ mmm dd" 
#define bool int strncpy (&D[12] ,&SYSTIME[ 0),3); /* "www" 
#define false 0 D(15) = ‘\0': /* nul 
#define true 3 strncpy(&T[ 0], &SYSTIME[11],8); /* "hh:mm:ss" 
#define max(x,y)} ((x) >= (y) 2? (x) = (y)) TL 8) = ‘\0'; /* nul 
strcepy (P_CURDATE, D) ; 
EXTERNAL extern st repy (P_CURTIME, T); 
#include <stdio.h> 
#include <dos.h> 
#include <time.h> local void DBUGTIME() 
fundef EXTERNAL /* Display date if date has changed. Display time. */ 
#define EXTERNAL { 
#define EXTRINIT static string FUNC[] = "DBUGTIME"; 
finclude <debug.h> string CURDATE[20+1); 
#undef EXTRINIT string CURTIME[20+1); 
#undef 
/* begin */ 
#define ENVFLAG /* PILEFLAG if debug level flags are NEWTIME (CURDATE, CURTIME) ; 
in file. ENVFLAG if debug level if (strncmp(CURDATE, PREVDAT,11) != 0) { 
flags are in environment. */ st repy (PREVDAT, CURDATE) ; 
#ifdef FILEFLAG fprint f (DBUGHNDL, "\n%s\n\n", CURDATE) ; 
local string FLAGNAME[] = "debug. flg"; } 
#fendif fprintf(DBUGHNDL, "%s ",CURTIME) ; 
} 
local string DBUGNAME[] = "debug. lst"; i 
local string PREVDAT[20+1] = ” : local void DBUGXLCH(P_S,P_C) 


Listing continues 


PROGRAMMERS! 
THE Too.s You NEED 
AT A PRICE YOU’LL LIKE 


Supports all index file operations. Very quick 
sequential or random access, duplicate keys, multiple 75.00 NOW 
indices, fixed and variable length data records are all supported. 


MULTI 


Works on top of BTree to provide a simple, yet -USER 
powerful application program/file system interface. 40.00 AVAILABLE 
Complex filesystem manipulation becomes a snap. Provides the power 
of a database manager with the flexibility of a programming language. 60.00 


Finally, a completely device independent printer library! 

Ip drives any printer as accurately as possible and allows easy access to 75.00 
its most sophisticated features. Multiple fonts, multi-column output, complex margin 
formatting, and much more. Pays for itself the first time it’s used. 

al STE LCM The ultimate ‘make’ utility. We couldn't find a good one, so 
we wrote a great one. Has all kinds of powerful features including wild 59.00 
card filename expansion, nested macros, and multiple dependency and rules defini- 
tions. Ready to go for MS-DOS; C source is there if you use another operating 
system. 


Combine & Save: BTree + ISAM + Ip 159.00+ snake 199.00 


Each product includes a typeset manual, example programs, and complete C source 1343 Stanbury Drive 
code that runs on any operating system. Softfocus products may be incorporated into Oakville, Ontario, Canada 
applications royalty-free. L6L 2J5 


Credit card orders accepted. Visa, M/C, Amex. Dealer inquiries invited. (416) 825-0903 
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This package can be tested by means of the example 
DEMODBUG.C (Listing 4). This example assumes a C com- 
piler that allows a preprocessor variable to be defined as an 
argument on the compiler command line (DEBUG_1). De- 
bugging code is not included unless DEBUG_1 is defined. 

The debug flags used are given as follows: 


Debug Flags Description 


DBUGFLG1 __ conditional debugging output from main 
program 

DBUGFLG2 __ conditional debugging output from first 
function level 

DBUGFLG3 conditional debugging output from second 


function level 


The function call DBUGOPEN appears in ‘“‘main’’ and as- 
sures that all debug flags are set according to the environ- 
mental variables, and will note that the debug output file is 
opened. 

The flow trace is accomplished by the function call 
DBUGBEGN at the beginning of each function and the func- 
tion call DBUGEND at the end of each function. 


Additional debug calls 
may be used to display 
intermediate results, but 
a display of input 
parameters, output 
parameters and return 
values may be 

sufficient. 


The input parameters are displayed by the DBUGxxxx 
calls at the beginning of each function. The output param- 
eters and the return values (if any) are displayed by the 
DBUGxxxx calls at the end of each function. Additional de- 
bug calls may be used to display intermediate results, but a 
display of input parameters, output parameters, and return 
values may be sufficient. 

The debug output file DEBUG.LST is given in Listing 5. 
Note that all lines are time-stamped. This is of some use, but 
generally the debugging code takes more time than the rest 
of the code. 

This program has been used with the Computer Innova- 
tions C86 Compiler Version 2.30f under MS-DOS/2.11 on a 
Lomas Lightning Computer (8086). With a suitable modifi- 
cation of the routines DBUGPTR and DBUGSTAK, it has also 
been used with a C compiler under UNIX/5 on the AT&T 3B2 
Computer and also under UNIX on the Plexus P-—40 
Computer. oO 


Bill Rogers is a consultant in Princeton, New Jersey. 


All the source code for articles in this issue is available 
on a single, MS-DOS disk. To order, send $14.95 to: Micro/ 
Systems, 501 Galveston Drive, Redwood City, CA 94063, or 
call (415) 366-3600, ext. 216. Please specify the issue num- 
ber. Source code is also available on CompuServe; type GO 
DD] FORUM. 
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P_S(]; 
PC; 


/* out. */ 
/* ing */ 


string 


metachar 


/* Translate a character so that it is "printable". */ 


static string FUNC[] = "DBUGXLCH"; 


metachar RIN; 
local char LEADINCH = '*'; 
local char LTZEROCH = ‘!'; 
local char EOFCH = 8; 
local char BIGCH = ET) 
local char DELCH = 12'S 
/* begin */ 
P_S[0] = '2'; 
P_S(1] = '2'; 
P_S[2] = ‘\0'; 
if ((P_C == LEADINCH)) { 
/* Double leadin. */ 
P_S[0] = LEADINCH; 
P_S(1] = PC; 
PS[2] = ‘\0'; 
} else if ((P_C< 0) { 


/* Unknown character (< 0) */ 


P_S[0] = LEADINCH; 
P_S[1] = LTZEROCH; 
P_S[2] = ‘\0'; 
else if ((P_C >= 0) 6& (PC <= 31)) { 
/* Control characters. 
P_S[0] = LEADINCH; 
PS(1] = PC + ‘@; 
P_S(2) = ‘\0'; 
else if ((P_C >= 32) && (P_C <= 126)) { 


/* Printable characters. Include space here. 


P_S[0] = PC; 
P_S(1] = ‘\0'; 
else if (P_C == 127) { 


~ 


/* Special handling for del. 


P_S{0] = LEADINCH; 

P-S{1] = DELCH; 

P_S[2] = '\0'; 
else if (P_C == -1) { 


/* End of file "character". 


P_S[0] = LEADINCH; 

P_S[1) = EOFCH; 

P_S[2] = ‘\0'; 
else { 


/* Unknown character (> 127). 


P_S[0] = LEADINCH; 
P_S(1] = BIGCH; 
P_S[2] = ‘\0'; 
} 
}  /* end DBUGXLCH */ 


local void DBUGXLST(P_TARGET,P SOURCE) 


string P_TARGET[]; 
string P_SOURCE[]; 


/* out. */ 
/* ine */ 


/* Translate a string into a "printable" string. */ 


static string 


FUNC[] = "DBUGXLST"; 
int Le 


TEMP(2 + 1]; 


string 
/* begin */ 
I =0; 
P_TARGET[O] = ‘\0’; 
while (P_SOURCE[I] != ‘\0') { 


DBUGXLCH (TEMP, P_SOURCE[I]} ; 
strcat (P_TARGET, TEMP) ; 

I++; 

end DBUGXLST */ 

public void DBUGBEGN(P_FUNC,P_SCCSID) 


P_FUNC[]; 
P_SCCSID[]; 


/* in */ 
f® An*s 


string 
string 


/* Begin debug of a function P_FUNC with sccsid 
P_SCCSID. */ 
{ 
static string FUNC[] = "DBUGBEGN"; 
/* begin */ . 
if (! DBUGOPFL) { 
DBUGOPEN () ; 
} 
DBUGTIME () ; 
fprint f(DBUGHNDL,"%-8s: Begin with SCCSID=’$%s’ \n", 
P_FUNC,P_SCCSID); 
fflush (DBUGHNDL) ; 
} /* end DBUGBEGN */ 


Exclude space here. */ 


*/ 


*/ 


Lid 


wf 


Listing continues 
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Interlocking Pieces: 


Blaise and 
Turbo Pascal. 


Whether you’re a Turbo Pascal expert or a novice, you can benefit from using professional tools 
to enhance your programs. With Turbo POWER TOOLS PLUS™ and Turbo ASYNCH PLUS™ 
Blaise Computing offers you all the right pieces to solve your 4.0 development puzzle. 


Compiled units (TPU files) are provided so each package is ready to use 
with Turbo Pascal 4.0. Both POWER TOOLS PLUS and ASYNCH PLUS 
EK, use units in a clear, consistent and effective way. If you are familiar 
"ge with units, you will appreciate the organization. If you are just getting 
started, you will find the approach an illustration of how to construct 
and use units. 


@POWER TOOLS PLUS is a library of over 180 powerful functions 
and procedures like fast direct video access, general screen 
oe Lam handling including multiple monitors, VGA and EGA 50-line 
and 43-line text mode, and full keyboard support, including 
the 101/102-key keyboard. Stackable and removable win- 
dows with optional borders, titles and cursor memory 
provide complete windowing capabilities. Horizontal, ver- 
tical, grid and Lotus-style menus can be easily incorporated 
into your programs using the menu management routines. 
You can create the same kind of moving pull down menus 
that Turbo Pascal 4.0 uses. 


Control DOS memory allocation. Alter the Turbo Pascal heap 
size when your program executes. Execute any program from 
within your program and POWER TOOLS PLUS automatically 
compresses your heap memory if necessary. You can even force 
the output of the program into a window! 


Write general interrupt service routines for either hardware or 
software interrupts. Blaise Computing’s unique intervention 
code lets you develop memory resident (TSRs) applications 
that take full advantage of DOS capabilities. With simple pro- 

"=" cedure calls, “schedule” a Turbo Pascal procedure to execute 
silver when pressing a “hot key” or at a specified time. 


~ @ASYNCH PLUS provides the crucial core of hardware interrupts 
needed to support asynchronous data communications. This package offers 
~ simultaneous buffered input and output to both COM ports, and up to four 
ports on PS/2 systems. Speeds to 19.2K baud, XON/XOFF protocol, hard- 
ware handshaking, XMODEM (with CRC) file transfer and modem control 
are all supported. ASYNCH PLUS provides text file device drivers so you 
can use standard “ReadIn” and “Writeln” calls and still exploit interrupt-driven 
communication. 


The underlying functions of ASYNCH PLUS are carefully crafted in assembler 
and drive the hardware directly. Link these functions directly to your application 
or install them as memory resident. 


Blaise Computing products include all source code that is efficiently crafted, 
readable and easy to modify. Accompanying each package is an indexed 
manual describing each procedure and function in detail with example 
code fragments. Many complete examples and useful utilities are 
included on the diskettes. The documentation, examples and 
source code reflect the attention to detail and commitment to 
technical support that have distinguished Blaise Computing over 
the years. 


Designed explicitly for Turbo Pascal 4.0, Turbo 


PLUS provide reliable, fast, professional routines— § Y¥ te 


the right combination of pieces to put your Turbo Pascal, VEN ease sen 


puzzle together. Complete price is $129.00 each. 1 sedi jgents 


4 UPS shipP! 
ae. \ Name- 


2560 Ninth Street, Suite 316 Berkeley, CA 94710 (415) 540-5441 Lee 


om 
POWER TOOLS PLUS and Turbo ASYNCH p== 5 Send. me the F 


SSS ec es 4 ress 
BLAISE COMPUTING INC. 4c sant 


BLAISE 
N U 


a 


Turbo POWER SCREEN $129.00 
NEW! General screen management; paint 
screens; block mode data entry or field-by- 
field control with instant screen access. Now 
for Turbo Pascal 4.0, soon for C and BASIC. 


Turbo C TOOLS $129.00 
Full spectrum of general service utility func- 
tions including: windows; menus; memory 
resident applications; interrupt service rou- 
tines; intervention code; and direct video 
access for fast screen handling. For Turbo C. 


C TOOLS PLUS $129.00 
Windows; menus; [SRs; intervention code; 

screen handling and EGA 43-line text mode 
support; direct screen access; DOS file han- 
dling and more. Specifically designed for’ 
Microsoft C 5.0 and QuickC. 7 


ASYNCH MANAGER $175.00 
Full featured interrupt drivensupport for the 
COM ports. I/O buffers up to 64K; XON/ 
XOFF; up to 9600 baud; modem control and 


XMODEM file transfer. For Microsoft Cand “= 


Turbo C or MS Pascal. : 
PASCAL TOOLS/TOOLS 2 $175.00 — 


Expanded string and screen handling; graph-- 
ics routines; memory management; general 


program centrol; DOS file support and more: 2 : 


For MS-Pascal. omy 
KeyPilot 549.95 


“Super-batch” program. Create batch files’ - 
which can invoke programs and. provide. input... 


to them; runany program unattended; create * e 


demonstration programs; analyze keyboard .. : 
usage. ; ; 3 


EXEC $95. 00 
NEW VERSION! Pree chaining. exe¢u- 
tive. Chain one program from another in © 
different languages; specify common: data’ * 
areas; less than 2K of overhead. ° poe 


RUNOFF : "$49.95 i 
Text formatter for all programmers. Written.” 
in Turbo Pascal: flexible printer control} user « 
defined variables; index generaiony aor we 
zeneral macro facility. 


TO ORDER CALL TOLL FREE 
800-333-8087 


TELEX. NUMBER - 338139. 


4 piec copie : 
for — on on Your Pg $4.00 for 
ore inform estic © “gard ait. ee 
Fe ered press st ) 
‘eS .<) 
Ph 


aig 4 lind OuiokC are : 
repistered trademarks of 
. ficrosoft Corporation. Turbo Pascal is a regis 
tered trademark of Borland International: 


/* begin */ 
public void DBUGBIN(P_FUNC,P_ NAME, P_VALUE} if (! DBUGOPFL) { 
= = ~ DBUGOPEN () ; 
string P_FUNC[]; ve i } 


string P_NAME[]; /* DBUGTIME() ; 
unsigned int P VALUE; fprintf(DBUGHNDL,"%-8s: %-16s=%.15e\n",P_FUNC,P_NAME,P_ VALUE) ; 


fflush (DBUGHNDL) ; 


/* Print a binary integer name P_NAME value P_VALUE /* end DBUGDBL */ 


in function P_FUNC. */ 
a public void DBUGEND(P_FUNC) 
static string FUNC[] = "DBUGBIN"; 
string VALUE [16+1]; 


unsigned int MASK; 
int Ty /* End debugging a function P_FUNC. */ 


string P_FUNC[]; 


/* begin */ static string FUNC[] = "DBUGEND"; 
if (! DBUGOPFL) { 


DBUGOPEN () ; /* begin */ 
} if (! DBUGOPFL) { 


DBUGOPEN () ; 


st repy (VALUE, ”"); } 
MASK = 0x8000; DBUGTIME(} ; 
for (I= 0 ; I< 16; I++) fprintf(DBUGHNDL, "t-8s: End\n",P_ FUNC); 


if (P_VALUE & MASK) { fflush (DBUGHNDL) ; 
st reat (VALUE, "1"); /* end DBUGEND */ 


} else { 
strcat (VALUE, "0"); public void DBUGFLOT(P_FUNC,P_NAME,P_ VALUE) 


} 
MASK = MASK >> 1; string P_FUNC[]; /® dn */ 


} string P_NAME[]; /* in */ 
DBUGTIME () ; long float P_VALUE; /* in */ 


fprintf (DBUGHNDL,"%-8s: %-16s=%-16sb\n",P_FUNC,P_NAME, VALUE) ; 
fflush (DBUGHNDL) ; /* Print float name P_NAME value P_VALUE in 


/* end DBUGBIN */ function P_FUNC. */ 


—----------------------*/ 


public void DBUGBOOL(P_FUNC,P_NAME,P VALUE) static string FUNC[] = "DBUGFLOT"; 


string P_FUNC[]; /* in */ 7* begin */ 

string P_NAME[]; /* in */ if (! DBUGOPFL) { 

int P_VALUE; /* in */ DBUGOPEN () ; 
} 


/* Print an integer name P_NAME value P_VALUE in DBUGTIME () 7 
function P FUNC, */ ~ ~ fprintf£(DBUGHNDL,"%-8s: %-16és=%e\n",P FUNC, P_ NAME, P_ VALUE) ; 


ff1lush (DBUGHNDL) ; 


static string FUNC[] = "DBUGBOOL"; /* end DBUGELOT */ 
string TEMP [8]; 
public void DBUGHEX(P_FUNC,P NAME, P_VALUE) 
/* begin */ 

if (! DBUGOPFL) { string P_FUNC[]; /* in */ 

DBUGOPEN () ; string P_NAME[]; /* in */ 
} int P_VALUE; f* in */ 
if (P_VALUE} { 

strcpy (TEMP, "true”); /* Print hex integer name P_NAME value P_VALUE in 
} else { function P_FUNC. */ 

st repy (TEMP, "false"); 
} static string FUNC[] = "DBUGHEX"; 
DBUGTIME () ; 
fprintf(DBUGHNDL, "%-8s: %-16s=%s\n",P_FUNC, P_NAME, TEMP) ; /* begin */ 
fflush (DBUGHNDL) ; ~ ~ if (! DBUGOPFL) { 
/* end DBUGBOOL */ ; DBUGOPEN () ; 


public void DBUGCHAR(P_FUNC,P_NAME,P_ VALUE) DBUGTIME() 
- fprint£(DBUGHNDL, "$-8s: %-16s=%4xh\n", P_FUNC,P_NAME,P VALUE); 


string P_FUNC[]; /* in */ £f1lush (DBUGHNDL) ; 
string P_NAME[]; /* in */ /* end DBUGHEX */ 
metachar P_VALUE; /* in */ 
public void DBUGINT(P_FUNC,P NAME,P VALUE) 
/* Print character name P_NAME value P_VALUE in 
function P_FUNC. */ string P_FUNC[]: /* in */ 
string P_NAME[]; /* in */ 
static string FUNC[] = "DBUGCHAR"; int P_VALUE; /* in */ 


string TEMP [2 + 1): 
/* Print integer name P_NAME value P_VALUE in 


/* begin */ function P_FUNC. */ 
if (! DBUGOPFL) { 
DBUGOPEN () ; static string FUNC[] = "DBUGINT"; 
} 
DBUGTIME () = /* begin */ 
fprint£(DBUGHNDL, "t-8s: %-16s=",P_FUNC,?_ NAME): if (! DBUGOPFL) { 
DBUGXLCH (TEMP, P_ VALUE) ; DBUGOPEN () ; 
fprint £ (DBUGHNDL, "’%s‘ \n", TEMP) ; } 


ff1lush (DBUGHNDL) ; DBUGTIME() ; 
/* end DBUGCHAR */ fprint £(DBUGHNDL, "%-8s: %-16s=%6d\n",P_FUNC,P NAME,P VALUE); 


£f1ush (DBUGHNDL) ; 
public void DBUGDBL(P_FUNC,P NAME, P_ VALUE) /* end DBUGINT */ 


string P_FUNC[]; /* in */ public void DBUGLONG(P_FUNC,P NAME,P VALUE) 
string P_NAME[]; /* in */ 
long float P VALUE; /* in */ string P_FUNC[); /* in */ 
* string P_NAME[]; /* in */ 
/* Print long float name P_NAME value P VALUE in long int P_VALUE; /* in */ 
function P_FUNC.*/ 


static string FUNC{] = "DBUGDBL"; 
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/* Print long integer name P_NAME value P_VALUE in 
function P FUNC. */ 


static string FUNC[] = "DBUGLONG"; 


/* begin */ 
if (! DBUGOPFL) { 
DBUGOPEN () ; 
} 
DBUGTIME () ; 
fprintf(DBUGHNDL, "%-8s: %-16s=%11ld\n",P FUNC,P NAME,P VALUE); 
f£f1.ush (DBUGHNDL) ; 
/* end DBUGLONG */ 


public void DBUGOPEN(} 


/* open debug file. Debug file is automatically opened 
when ANY dabug function called. */ 


static string FUNC[] = "DBUGOPEN"; 
FILE *FLAGHNDL; 

unsigned char *FLAGPTR; 

metachar Cc; 

string FLAGLIT(128]; 
extern unsigned char *envfind(); 

extern char *upper(); 


/* begin */ 
if ( ! DBUGOPFL) { 
DBUGOPFL = true; 


/* Set debug level flags from file */ 
ifdef FILEFLAG 
FLAGHNDL = fopen(FLAGNAME, "r") ; 
if (FLAGHNDL != 0) { 
while (true) { 
C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C == 1’) { 
DBUGFLGO = true; 
} 
} else { 
break; 


} 


C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C == ‘1') { 
DBUGFLG1 = true; 
} 
} else { 
break; 
} 
C = fgetc(FLAGHNDL) ; 
if (Cc != EOF) { 
if (C == ‘1') { 
DBUGFLG2 = true; 
} 
} else { 
break; 
} 
C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C =='1') { 
DBUGFLG3 = true; 
} 
} else { 
break; 
} 
C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C == ‘1') { 


DBUGFLG4 = true; 


} 
} else { 
break; 
} 
Cc = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C == '1') { 


DBUGFLG5 = true; 


} 
} else { 
break; 
} 
C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C == ‘1') { 


Listing continues on page 54 


Introducing the OpenEnder ‘Intelligent 


MultrChannel Communications Board for PS/2. 
And your choice of I/O Mates: 


ge 


Now, with DigiBoard OpenEnder™ Intelligent 
Communications Boards, you can channel the power of IBM 


for the expensive intelligent part once. Because your I/O 
functions are handled by affordable [/O Mate™ modules 


So, for the first time in the history of 
intelligent communications boards, your I/O 
options are wide open. And they always will be. 


Personal System/2 to up to 32 users. 400% faster than the that simply plug in. 
boards you're probably using now. . 
But what really sets DigiBoard D Q ai 
Plugging you into tomorrow. 


OpenEnders apart is that you only have to pay 


Call 1-800-344-4273. In Minnesota, (612) 922-8055. 
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Using 
MS-DOS 
Functions 


in C 


by Mark Zeiger 


Modularize your 
C program to 
make it portable 
between operating 
systems. 
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ost MS-DOS C compilers boast that they are 

“UNIX-compatible’”’ and that their code can be 

ported to a UNIX system with “‘ittle or no 
change.”’ However, I have found that some desirable fea- 
tures of UNIX cannot be emulated in a straightforward man- 
ner under MS-DOS. 

There are also other functions that suffer in performance 
under MS-DOS if they are imitated. In UNIX, for example, 
the command processor expands wildcard file names. For 
instance, if there are four files in the current directory (fn1, 
fn2, fn3, and fn4), then calling a program prog *.* with the 
standard entry of main(argce, argu) will have argc = 5, 
argv[0] = prog, arge[1] = fnl, arge[2] = fn2, argr[3] = 
fn3, and argv[4] = fn4. Under MS-DOS argc would equal 2 
and argv[1] would be *.*. The value of argv/0] would depend 
on the particular compiler being used, since MS-DOS ver- 
sions earlier than 3.0 do not return the program name from 
the parameter line. 

Also, many of the functions found in UNIX C compilers are 
not implemented in MS-DOS C compilers. This is because 
there is simply no equivalent UNIX system call in the MS- 
DOS environment. One example is the time and date func- 
tions of UNIX. MS-DOS does not return all the information 
about time zones, day of week, and other things that UNIX 
does (although some of the new DOS compilers do support 
such functions). 

Further, control of screen and console functions is com- 
pletely different under the two systems. For instance, if the 
user wishes to use the console input with no echo (writing a 
screen editor, for example), he or she must use function 6 
under MS-DOS and IOCTL functions with UNIX. 

The purpose of this article is to describe how MS-DOS 
function calls from a C program may be used. Using such 
function calls from a C program will make code non-portable 
between various operating systems. However, if the code is 
modularized well, then only certain sections will have to be 
changed to port an application from one system to another. 
Also, many utility programs (such as the one in this article) 
will probably never have to be ported to another system 
since either the other system already has the utility or the 
utility cannot be supported. 

The program is called CHATT (CHange ATTributes, List- 
ing 2). It can set or reset the system, hidden, and read/only 
attributes of files in MS-DOS. It is possible to change the 
attributes of many files in different directories with one 
command line: 


chatt -s+r \*.com £*.asm subdir! 


This will reset the system attribute and set the read/only 
attribute in all the .COM files in the root directory, all the 
.ASM files starting with fin the current directory, and, as- 
suming subdir] is a subdirectory, all the files in the direc- 
tory subdir1. To accomplish this in MS-DOS, you must use 
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the search first and search next functions, which are not 
usually implemented in standard libraries of MS-DOS C com- 
pilers. Also, some older compilers do not have functions that 
allow you to change the file mode (the more recent compil- 
ers do); therefore changing the attribute must be imple- 
mented as a DOS function call. And finally, some simple 
things, such as receiving a single character (without press- 
ing RETURN and without having the character echo to the 
screen) are sometimes not implemented in many C libraries. 
The source listing of CHATT shows how to accomplish many 
of these tasks. 


CHATT (CHange 
ATTributes) can set or 
reset the system, hidden, 
and read/only attributes 
of files in MS-DOS. It is 
possible to change the 
attributes of many files 
in different directories 
with one command line. 


Calling MS-DOS From C 

The actual method of calling an MS-DOS function from C 
varies from implementation to implementation. Two exam- 
ples that I have seen (which allow full control of all registers) 
are the following: 


1. Microsoft, Lattice, Eco-88, 

and Turbo C Implementations 

This method requires a pointer (the address) to two struc- 
tures as well as the DOS function number. The structures 
are the register sets, which are unsigned integers for the 
8086/88 and 80286. The state of the CPU flags is returned. 
The first structure contains the register values that MS-DOS 
expects. The second structure contains the register values 
set by MS-DOS upon return from the system call. The regis- 
ters themselves are unsigned 16-bit values; therefore these 
calls are not only highly MS-DOS-dependent, they are also 
very CPU-dependent. 

For example, to send a single character to the console 
under MS-DOS, the ASCII representation of the character is 
placed in the DL register and 6 is placed in the AH register. 
Then the INT 21h instruction is executed. The assembly 
language routine would be: 


mov dl1,'A' 
mov ah,6 


;print upper case ”A” 
;raw console output 
;function of DOS 

int 21h ;call DOS 

The method of doing this in C would be: 
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/* define the structure */ 

struct REGS { unsigned ax,bx,cx,dx,si,di,es; }; 

unsigned flags; 

struct REGS inr, outr; /* create two 
structures */ 

inr.dx = 'A'; /* 41 hex in DL */ 

inr.ax = 0x0600; /* 06 hex in AH, 00 in AL */ 

flags = sysint(0x21, 6inr, &o0utr); 


&inr is the address of the structure inv, which contains 
the values expected by the MS-DOS call; the structure outr 
will contain the values returned in the registers after the call 
(in this case nothing since the raw console output does not 
return anything). 

As an example of a function that returns a value, consider 
the call to get a character from the console (raw console 
input). MS-DOS expects an Off in the DL register and 6 in the 
AH register if input is desired. It then returns either with 
the zero flag set if no character is ready or with the charac- 
ter in AL. 


#define ZEROF 0x0001; /* zero flag is low 
order bit of CPU 
flags */ 

struct REGS inr, outr; 

unsigned flags; 


do { 
inr.dx = 0x00ff; /* console input 
sub-function */ 
inr.ax = 0x0600; 
flags = sysint(0x21, éinr, éo0utr); 
} while ( (flags & ZEROF) == ZEROF); 


Upon exit from the DO loop, outr.ax contains the charac- 
ter in the lower eight bits. To echo it, we can: 


inr.dx = outr.ax & Ox00ff; /*clear DH 
register.*/ 

inr.ax = 0x0600; 

sysint(0x21, Sinr, soutr); /* flags do not 
matter here */ 


2. DeSmet C Implementation 

This implementation is much simpler. It depends upon the 
external, pre-defined unsigned variables _vax, _rbx, _rcx, 
_rdx, _rsi, _rdi, res, and _rds, as well as on the external 
character variables _zerofand _carryf. The last two will be 
set to either 0 or 1, depending on the state of the flags after 
the call. The call is _doint(interrupt no). Console I/O 
would be implemented in DeSmet C as follows: 


do { /* wait for character */ 
=rdax OxOOFE ; 
—rax = 0x0600; 
—doint(0x21); 
} while (_zerof); /* character is in _rax */ 


—rdx = _rax & 0x00f£; /* echo character */ 
—rax = 0x0600; 
—doint(0x21); 


One word of caution in using the —doint() function of 
DeSmet C. The variable _ rds must be set to — 1 if the value 
of the DS register is not to change during the DOS call. In 
the above examples the data segment has no meaning, so 
nothing must be done. If we consider a call that changes the 
disk transfer address (DTA) in MS-DOS, then we must be 
very careful with the data segment. Here, the correct call 
would be: 
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Listing 1. Executing a Microsoft-type system call 


flags = sysint(function_number, éinr, éoutr) 


assuming small memory model and C compiler 
;parameters are pushed from left to right on stack 
;segments $b$prog and $d$dataseg are unique to 
slinking object modules using Eco-C88 Compiler. 
;They will probably have to be changed for other 
;compilers. 


public _sysint 


$d$dataseg segment 
inter_no dw 0,0 :patched to pointer to interrupt.. 
$d$dataseg ends ;..requested 


$b$prog segment 
_sysint proc near 
push bp ;standard assembly language interface.. 


mov bp,sp 3..to C programs 


stack is as follows if small if not small 


+ address of outr structure bpt+8 bpt+10 
; address of inr structure bp+6 bpts 
+ function number bp+4 bpt+é 
+ return address bp+2 bp+2 
; bp <--bp bp 


;if not small memory model, then return address 
+ would occupy 2 words 


it is not usually necessary to save registers 
sother than BP when calling C functions. 


mov ax, [bp+4] ;get MS-DOS function number in AL 

mov ah,35h #MS-DOS get interrupt vector function 
int 21h sreturns with vector in ES:Bx 

mov {inter_no],bx ;store vector in memory for later.. 


mov [inter_no+2],es ;..far call 

mov bx, [bp+6] 7bx <- address of inr structure 

mov ax, [bx] yax <- inr.ax 

mov cx, [bx+4] sex <- inr.cx 

mov dx, [bx+6] sax <- inr.dx 

mov si, [bx+8] ssi <- inr.si 

mov di,[bx+10] ;di <- inr.di 

mov es,[bx+12] ;es <- inr.es 

mov bx, [bx+2] zbx <= inr.bx 

pushf ;this emulates an 8086 interrupt.. 

call dword ptr [inter_no] ;..which first pushes 
flags and.. 


#..then does far call 


sInterrupt done. The pushf has been handled by IRET of 
sinterrupt procedure. Now put resulting registers in 
soutr struct 


push bx 
mov bx, [bp+8] sbx <- address of outr structure 
mov [bx],ax soutr.ax <- ax 


mov [bx+4],cx ;outr.cx <- cx 
mov [bx+6]),dx ;outr.dx <- dx 
mov [bx+8),si ;outr.si <- si 
mov [bx+10],di ;outr.di <- di 
mov [bx+12],es ;outr.es <- es 


pop cx show cx equals bx before bx was pushed 
mov [bx+2],cx 

pushft sax <- flags as return value 
pop ax return values in AX 

ret 


_sysint endp 
$b$prog ends 
end 


Listing 2. CHATT—A program to change the attributes 
of MS-DOS files 


0001: /* CHATT - change attribute. 
0002: 
0003: Changes file mode to or from READ/ONLY, SYSTEM, or HIDDEN 


... listing continued 
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HIGH PERFORMANCE RAM 


| 256 K CMOS STATIC RAM 
| LITHIUM BATTERY BACKUP 


a 


it 
Seg ia & on 


Compupro 
Ram 22 


Octagon 
256K 


Cromemco 
256KZ | 


Dynamic 
Boards 


BG-Bank 
2568S 


ED IN YOUR SYSTEM 
CROMIX-D e MPM e CCS e OASIS e AMOS 


Vv PLUS: 8/16 BIT TRANSFERS e 24-BIT EX. ADDRESSING 
8-12 MHZ @e 2K DESELECTS e RAM-EPROM MIX 
IEEE 696/S-100 e LOW POWER e FULLY STATIC 


LITHIUM BATTERY BACKUP avoids power failure crashes intel- 
ligently. Unique POWER-FAIL-SENSE circuit allows processor 
to save register information and disable board before POWER 
FAILURE CRASHES memory. 


BG BANK 256S $329 
BG BANK 64S $249 


Battery Backup 
Battery Backup 


BG COMPUTER APPLICATIONS, 206 Brookside, 
Bryan, Texas 77801. International orders add 30%. 


(409) 775-5009 
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ALL SALES ARE MADE SUBJECT TO THE TERMS OF OUR 90 DAY LIMITED WARRANTY. A COPY OF THIS WARRANTY IS AVAILABLE FREE, ON REQUEST. 


DIGITAL RESEARCH COMPUTERS 
(214) 225-2309 


$100 EPROM PROGRAMMER 

OUR NEWEST DESIGN, FOR FAST EFFICIENT PROGRAMMING OF THE 

MOST POPULAR EPROM'S ON YOUR S100 MACHINE. COMES WITH 

MENU DRIVEN SOFTWARE THAT RUNS UNDER CP/M 2.2 (8 INCH). PC 

BOARD SET CONSISTS OF ($100) MAIN LOGIC BOARD REMOTE 

PROGRAMMING CARD AND SIX PERSONALITY MINI BOARDS FOR 

2716, 2532, 2732, 2732A, 2764, AND 27128. SOLD AS BARE PC BOARD ' 
SET ONLY WITH FULL DOC. SOFTWARE FEATURES “FAST” LOW POWER! 
PROGRAMMING ALGORITHM. FOR Z80 BASED SYSTEMS. 150 NS ADD $10 


BLANK PC BOARD 
PC BOARD SET, FULL 
DOCUMENTATION, 8 IN. WITH DOCUMENTATION 


DISKETTE WITH SOFTWARE. $49.95 FeEaTuRES: PRICE CUT! 
Ce SUPPORT ICs +CAPS * pete new 2K x8 ata pal or bi one) RAMs. 
ully supports 96 24 BI xtended 
PRI , §39% — Aadressing. I i ly 500 MA. 
raws only approximately 500 \. 
cuT FULL SOCKET SET * 200 NS RAMs are standard. (TOSHIBA makes 
$14.50 TMM 2016s as fast as 100 NS. FOR YOUR HIGH 
SPEED APPLICATIONS 


128K S100 STATIC RAM/EPROM BOARD | FULLY SUPPORTS THE , sUsponTs PHANTOM (BOTH LOWER 32K 


NEW !EEE 696 S100 AND ENTIRE BOARD). 
JUST OUT! USES POPULAR 8K X 8 STATIC RAMS (6264) OR 2764 
EPROMS. FOR 8 OR 16 BIT DATA TRANSFERS! IEEE 696 STANDARD. STANDARD 2 Any of the top Oh (£000 HAND ABOVE) may 
LOW POWER. KITS ARE FULLY SOCKETED. FULL DOC AND (AS PROPOSED) be disabled to provide windows to eliminate 
SCHEMATICS INCLUDED. 24 BIT ADDRESSING. Say possible conticrs withiyoureysten imonitor; 
isk controller, etc. 


$ 95 00 $ 00 Pertect f Il syst ince BOTH RAM and 
NEW! ‘99 $219 139 [ ASSEMBLED AND] * EBaGmay co-exston ine seme Dowd. 


BARE PC BOARD 128K RAM KIT 128 EPROM KIT BOARD may be partially populated as 56K. 


256K S-100 SOLID STATE DISK SIMULATOR! 1 MEG. S-100 SOLID STATE DISK SIMULATOR! 
WE CALL THIS BOARD THE “LIGHT-SPEED-100” BECAUSE IT OFFERS WE CALL THIS BOARD THE “LIGHT-SPEED-100” BECAUSE IT OFFERS 
AN ASTOUNDING INCREASE IN YOUR COMPUTER’S PERFORMANCE AN ASTOUNDING INCREASE IN YOUR COMPUTER’S PERFORMANCE 
WHEN COMPARED TO A MECHANICAL FLOPPY DISK DRIVE. WHEN COMPARED TO A MECHANICAL FLOPPY DISK DRIVE. 
FEATURES: ag hniopes a ortaniie 
* 256K on board, using + * eg. on board, using + 
_PRICE call DRAMS. tigi LS 1 00 II DRAMS. (With Parity)” 
. * Uses new Intel 8203-1 LSI Memory * Uses new Intel 8203-1 LS! Memory 
r ‘ 4 Controller. Controller. 
* Requires only 4 Dip Switch * Requires only 4 Dip Switch 
Selectable I/O Ports. t hhh Selectable 1/O Ports. 
== * Runs on 8080 or Z80 S100 machines. | #: q = 3; * Runs on 8080 or Z80 S100 machines. 
_ * Up to 8 LS-100 boards can be run t g ag: aT re = * Up to 4 LS-100 boards can be run 
“| together for 2 Meg. of On Line Solid pee Ne ALM together for 4 Megs. of On Line 
State Disk Storage. Fi ‘i * Solid State Disk Storage. 
a * Provisions for Battery back-up. , : | * Provisions for Battery back-up. 
* Software to mate the LS-100 to your i i “= * Software to mate the LS-100 to your 
CP/M* 2.2 DOS is supplied. Ey $ CP/M* 2.2 DOS is supplied. 
* The LS-100 provides an increase in r Smee: : * The LS-100 provides an Increase in 
speed of up to 7 to 10 times on Disk L 5 speed of up to 7 to 10 times on Disk 
Intensive Software. z ae ra, w = Intensive Software. 
* Compare our price! You could pay * Compare our price! You could pay 
BLANK PCB up to 3 times as much for similar BLANK PCB up to 3 times as much for similar 
(WITH CP/M* 2.2 boards. (WITH CP/M* 2.2 boards. $ 00 
PATCHES AND INSTALL ! * PATCHES AND INSTALL 
PROGRAM ON DISKETTE) CLOSE OUT! BLANK PCB ONLY: | | proGRaM ON DISKETTE)| (ADD $50 FOR A&T) 259 


$2495 $2495 $599 #LS-100 11 (FULL 1.M.B. KIT) 
8203-1 INTEL $29.95) #LS-100 (8203 1 INTEL $29.95) 1 MEGA BYTE! 


ZRT-80 ! THE NEW 65/9028 VT 
A LOW COST /CRT TERMINAL BOARD! AN ANSI VIDEO TERMINAL BOARD! 


ASCII KEYBOARD, POWER SUPPLY, AND VIDEO MONITOR TOMAKEA * FROM LINGER ENTERPRISES 
COMPLETE CRT TERMINAL. USE AS A COMPUTER CONSOLE, OR A second generation, low cost, high performance, mini sized, single 
WITH A MODEM FOR USE WITH ANY OF THE PHONE-LINE COMPUTER board for making your own RS232 Video Terminal. This highly versatile 
SERVICES. board can be used as a stand alone video terminal, or without a 
Dr Uteg a SADA iiensstGhe 5 : keyboard, as a video console. VT100, VT52 Compatible. 
ses a an 2 
i ; ; FEATURES: MICRO SIZE! 

pete sa powerubyiese ; : ‘ * Uses the new CRT9128 Video Controller 

RS232 at 16 BAUD Rates from 75 { i - i driven by a 6502A CPU 

to 19,200 : il M * On-Screen Non-Volatile Configuration 

24 x 80 standard format (60 Hz) x n * 10 Terminal Modes: ANSI, H19, ADM-5, 

Optional formats from 24 x 80 “ 3 WYSE 50, TVI-920, KT-7, HAZ-1500, ADDS 

(50 Hz) to 64 lines x 96 characters y : 60, QUME-101, and Datapoint 8200 

(60 Hz). j aa e id 5 * Supports IBM PC/XT, and Parallel ASCII 

Higher density formats require up to R- > - Sy Keyboards 

3 additional 2K x 8 6116 RAMS i * Supports standard 15.75 kHz (Horiz.) 

Uses N.S. INS 8250 BAUD Rate Gen “ * Composite or Split Video (50/60 Hz) 

and USART combo IC : : ? * 25 X 80 Format with Non-Scrolling User Row | 

3 Terminal Emulation Modes which soa * Jump or Smooth Scroll 

are Dip Switch selectable. These A&T + RS-232 at 16 Baud Rates from 50 to 19,200 

include the LSI-ADM3A. the Heath ADD * On Board Printer Port 

H-19, and the Beehive #ZRT-80 


i it Vi $50 * Wide and Thin Line Graphics 

te or Split Vid F 7 
Ft ccerhe koh Nideo or aii (COMPLETE KIT, 2K VIDEO RAM) * Normal and Reverse Screen Attributes $ g95 FULL KIT 
Inverse Video Capability * Cumulative Character Attributes: De-Inten, 


Small Size: 6.5 x 9 inches Reverse, Underline and Blank w/100 Page Manual 
Upper & lower case with descenders OUR BES T * x anu Keys and ADD $40 FOR A&T 

7 x 9 Character Matrix nswerback message 

Requires Par ASCII keyboard * 5 X 8 Character Matrix or 7 X 9 for IBM OPTIONAL EPROM FOR 


PC/XT STYLE SERIAL 
S EL L ER i Mentors, ’ | “KEYBOARD: $15 
FOR 8 IN. SOURCE DISK . * Mini Size: 6.5 X 5 inches SCONCE OETTE: 


OR ee 5% IN. * Low Power: 5VDC @ .7A, + 12VDC @ 20mA. PC/XT FORMAT 


TERMS: Add $3.00 postage. Orders under $15 add 75¢ handling. No 


Digital Research Computers C.0.D. We accept Visa and MasterCard. Tex. Res. add 6-1/4% Tax. 


Foreign orders (except Canada) add 20% P & H. Orders over $50 add 85¢ 
P.O. BOX 381450 » DUNCANVILLE, TX 75138 « (214) 225-2309 for insurance. 


*TM OF DIGITAL RESEARCH INC. (CALIF.) WE ARE NOT ASSOCIATED WITH DIGITAL RESEARCH INC. (CALIF.) THE SUPPLIERS OF CPM SOFTWARE 


char dta[128]; /* define 128 byte area */ 
_rdx = (unsigned) édta[0]; /* cast pointer to 
unsigned */ 
—rax = 0x1a00; /* set DTA function */ 
rds = -1; /* assume small memory... */ 
—doint(0x21); /* ..model by not 
changing DS */ 


If _rdsis not set to —1 or assigned a value, then it will be 
assigned the value 0. Thus the disk transfer area would have 
been set to 0000:(address of dta[0), probably wiping out 
the entire operating system. 

Suppose that your C implementation does not implement 
either of these methods but you wish to use one of them. The 
first method is easier to code. Listing 1 offers assembly lan- 
guage code that executes the Microsoft-type system call. 


0004: interactively by first displaying current mode and then 

0005: asking if you wish a change to be made. Wildcards may be 

0006: used. 

0007: 

0008: Created by Mark Zeiger 

0009; Written in Eco-C88 

0010: */ 

0011: 

0012: /* Command line parameters 

0013: 

0014: chatt [control] [path\]filename [[path\] filename ...] 

0015: 

0016: "Control" parameter specifies whether attribute should 

0017: be turned on or off and whether you should be asked if 

0018: change is to be done. 

0019: 

0020: R specifies READ/ONLY, H specifies HIDDEN, and $ specifies 
0021: SYSTEM. If path is not specified, default directory is 

0022: used. Filename may include wildcard characters. A direc- 

0023: tory alone is expanded to all files in directory (i.e. 

0024: test = test\*.* if test is a directory). 

0025: 

0026: An "N" in control parameter will allow changes to be make 

0027: without asking. If no control parameter is specified then 

0028: attributes will be displayed only. 

0029: 

0030: The control parameter takes the form of the string 

0031: +/-R | +/-B | +/-S | N in any order, except that "N" must 

0032: not come first (the control string must start with a + or 

0033: -). 

0034: example: 

0035: 

0036: chatt +r-htsn abc\*.com changes all COM files in directory 
0037: "abc" to READ/ONLY and SYSTEM and 

0038: takes away HIDDEN attribute. No 

0039: prompt is issued for each file. 

0040: 

0041:  chatt -sth abc\*.* d:*.asm changes all files in directory "abc" 
0042: to HIDDEN and all ASM files in current 
0043: directory of drive "D" to HIDDEN. Also 
0044: takes away SYSTEM attribute of those 
0045: files. You will be prompted if change 
0046: is to be done. 

0047: 

0048: + chatt -sth abc d:*.asm 
0049: 

0050: chatt \abc\*.com lists attributes of all COM files 
0051: in directory \abc. 

0052: 

0053: */ 

0054: 

0055: #define TRUE 1 

0056: #define FALSE 0 

0057: #define NULL 0 

0058: 

0059: /* DOS call parameters */ 
0060: 

0061: #define MSDOS 0x0021 
0062: #define SETMODE 0x4301 
0063: #define GETMODE 0x4300 
0064: #define SEARCH 0x4e00 
0065: #define SEARCHN 0x4£00 
0066: #define SETDMA 0xla00 
0067: #define CONIO 0x0600 
0068: #define CARRYF 0x0001 
0069: #define ZEROF  0x0040 
0070: 

0071: /* file attribute bits for function 43H */ 
0072: 

0073: #define RO 0x0001 

0074: #define HIDDEN 0x0002 

0075: #define SYSTEM 0x0004 


same as above. 


/* MS-DOS interrupt */ 
subfunction number in AL */ 
subfunction number in AL */ 
search for first occurance */ 
search for next occurances */ 
set DMA address */ 
raw console 1/0 */ 
position of carry flag */ 

/* position of zero flag */ 
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Using MS-DOS within C Applications 

Now that the calling conventions have been discussed, we 
can examine the program CHATT.C to see how MS-DOS 
functions can be used within C programs. The entire logic of 
the program lies in the FOR loop that starts on line 160 of 
Listing 2. However, before entering the loop, two items 
must be considered. 

First, since the program either accepts argv/1] as a con- 
trol string or as a file name, we must test a7gv/1] to see 
which it is. If the argument starts with a + or —, it is 
assumed to be a control string specifying which attributes to 
set or reset; otherwise, it is assumed to be a file name (if no 
control string is specified, then attributes will be displayed 
only). Therefore, lines 140-150 test the first character of 
the first argument for + or — and set appropriate flags 
depending on what is found. If there is a control argument, 


#define VOLUME 0x0008 
#define SUBDIR 0x0010 


/* errors from setmode and search commands */ 


#define NOFILE 0x0002 
fdefine NOPATH 0x0003 
#define NOACCESS 0x0005 
#define NOFILES 0x0012 


/* file not found 
/* path not found 
/* access denied 
/* no more files on SEARCHN */ 


/* BIOS interrupt 10H constants */ 


#define CURR VIDEO 0x0f00 
#define READ CURSOR 0x0300 
#define SET CURSOR 0x0200 
fdefine VIDEO_INT 0x0010 


/* Structure filled in by SEARCHF command of MSDOS */ 


struct DMA { 
char reserved(21]; /* reserved by MS-DOS */ 
char attribute; /* attribute of file */ 
unsigned time; 
unsigned date; 
unsigned size L; /* file size - low word */ 
unsigned size h; /* file size - high word */ 
char fname[13]; /* parsed name of file */ 
h 


/* Structures used by Eco-C88 for interrupt calls */ 
struct REGS { unsigned ax, bx,cx,dx,si,di,es; }: 
struct REGS inr, outr; 


[*-~----—-----—---—----- MAIN. -----—-------------—-—-*/ 


main(argc, argv) 


int argc; 
char targv[]; 


{ 

char attonoff, /* is it a+or- */ 
path[64], /* holds path name up to 64 bytes */ 
new_arg(64]; /* might hold subdir concat with \*.* */ 

int bslpos; /* position of last backslach in path name */ 

struct DMA dmabuf; /* used for MS-DOS search function */ 

int 43 /* used to count parameters */ 

int carryf; /* carry flag for MS-DOS calls */ 


void fpe(), bad_syntax(), pfname(), 

set_att_masks(), change_att(), 

concat (); 
char lastchar(); 
int getpath(); 
unsigned att_on mask, att_off mask; /* masks to set/reset attributes */ 
unsigned ask: /* prompt for each change 2??? */ 
int start file; /* which argv[] contains 1st path\file */ 
int display att_only; /* flag to display attribs only */ 


if (argc < 2) bad_syntax(); 


atton_off = argv(1] [0]; 

if (atton_off != '+' && atton_off != '-') { 
start file = 1; /* argv(1) is a path */ 
display att_only = TRUE; 

} 


else { 


... listing continued 
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the function set_att_masksis called. These masks are used 

later to set or reset file attributes. 0146: start file = 2; /* argv[{1] is control parameter */ 
The other task that must be performed is to set the MS- 0147: display att only = FALSE;  /* and argv(2) starts files */ 

DOS disk transfer area for the search first and search next | }\¥s pa ce ee aro 

functions. The search first function fills in the DTA (lines 150: 3} TEEN ene oe nN AE : 

95-104). Therefore MS-DOS function 1A hex is called with ae ; ; 

the address of the desired memory location in the DX regis- | {is3,/* “Sh M005 A fer address to cuabut */ 

ter (note that the cast from pointer to unsigned is necessary | 9154: inr.ax = SETDMA; 


with many of the C compilers—this cast is CPU-dependent). el Ni ai cal 


Line 156 seems to be necessary with some calls and not 0157: sysint (MSDOS, sinr, soutr): 


with others. It simply puts the current value of the DS regis- i 


ter in the extra segment (getds() is an Eco-C88 function 0160: for (i = start file; i < arge: iH) { 


that returns the value of DS). Although none of the MS-DOS 0161: ; 
0162: /* Changes a subdirectory name to subdir\*.* 


calls used in the program document the use of the ES regis- 0163: or changes root to full search (\ -> \*.*) 
ter, if the function is not performed, the program does not 0164: or changes drivespec to drivespec:\*.* (c: - > c:\*.*) 
work. Another option could be to rewrite the _sysint() | {i . 
function so that imr.es is not used. 0167: if (lastchar(argv[il) == ':") { 
0168: concat(new_arg, argv[i], "*.*"); 
0169: argv[i] = new_arg; 
0170: } 
0171: else if (lastchar(argv[i]) == ‘\\’) { 
0172: concat (new arg, argv[i], "*.*"); 
0173: argv[i] = new arg; 
, is: A { 
The search functions i 
‘ 0177: inr.dx = (unsigned) argv[i]; 
0178: carryf = int86(MSDOS, ginr, soutr); 
require a full file name CE eget 
0180: concat (new arg, argv[i], "\\*.*"); 
although some DOS ne. ae 
182: } 
0183: } 
ay [Pioat * us 0184: 
utilities require only a cs: ——_‘blgo = getpath angst 
0186: 
° 0187: fpe("\n=======-==-===8=====> "); 
subdirectory or even @ 0188: fpe(argv{i}): 
0189: fpe(" <enenemenaanannennen=\n") : 
° ° . 0190; 
drive specification. msl 
0192: inr.ax = SEARCHF; 
0193: inr.dx = (unsigned) argv[i); 
0194: inr.es = getds(); 
0195: inr.cx = Ox001f; /* search for file with any attri- */ 
ot carryf = sysint(MSDOS, sinr, soutr); /* bute except archive */ 
We can now enter the main program loop, starting with = : if tact « cum) — on { P — 
either argv[1] or argv[2] depending on whether argv/1]is a mane ay, DHE Seen BAA 
file name. The program searches for all files in a particular 0201: fpe(argy[i]): 
path that satisfy the wildcard conditions. seo ee 
The search functions require a full file name, although 0204: else { 
some DOS utilities require only a subdirectory or even a ne eee error \a\OO7t} 
drive specification. A common example is the dir a: com- 0207: } ‘ 
mand which DOS interprets as dir a:*.*. Also, a command point } 
such as dir abc, where abc is a subdirectory, is changed to 0210: while ( (carry£ & CARRYE) I= CARRYE) { 
dir abc\*.* by DOS. Unfortunately, the search functions re- 0211: pfnane(path, &(dmabuf.fname[0]), bslpos): 
quire a full file name and will not make the above expan- | {717 pubes, 
sions; these must be done in the program. Therefore we 0214: display type(dnabuf.attribute) ; 
must test the name for three things: 0215: if ( (display att_only != TRUE) && (dmabuf.attribute != SUBDIR)) 
0216: change att (path, dmabuf.attribute, att_on_mask, 
1. If the last character is a colon, we append the *.*charac- | 27: eee 
7% 0218: else fpe("\n"); 
ters to the file name (lines 167-170). Therefore A: be- 0219: 
comes A:*.*, jg 
A 221: inr.ax = SEARCHN; 
2. If the last character is a \, then the name must be a 0222: at getds(); 
subdirectory and we again append *.* (lines 171-174). poet carryf = sysint(MSDOS, sinr, soutr); 
3. If the name is a subdirectory (tested with the get file 0225: +} /* end of for loop */ 
attribute function of MS-DOS), then we concatenate a | 0226: ; 
\**to the path name (lines 175-183). tae} 
Note that the get attribute function is called with 43 hex oa : 


in AH. AL specifies whether to get or set the attribute (0 = 0231: /#-—---—----—----------—— SET_ATT_MASKS ~-~-~-----------—---—#/ 
ss e H 0232: 

get, = set). Also, D S:DX points to the address of the 0233: /* When it comes time to set or reset attributes, directory 

ASCIIZ file name. “‘ASCIIZ” is an abbreviation for an ASCII 0234: attribute byte will be "or"ed with "att_on mask" to set 

string ending with a byte of zeros. 0235: attribute bits we want on and then "and"ed with "att_off mask” 
. . 0236: to reset attributes we want off. This is done in function 

Now that argv/t] points to the full name, we are ready to 0237: "change att()". 

use the search functions. There is only one problem. The 0238: */ 7 

search functions fill the structure in the DTA with the first 

and subsequent names, but these names are only file names 


without the path. To change the attribute we are going to 
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void set_att_masks(att_string, att_on mask, att_off mask, ask) 


char *att_string; 
unsigned *att_on_mask, *att_off mask, *ask; 


{ 
int sub str(); 


*att_on_mask = 0; 
*att_off_mask = Oxffff; 


if (sub_str(att_string, "+R")) *att_on_mask |= RO; 
else if (sub str(att_string, "-R")) *att_off_mask &= RO; 


if (sub_str(att_string, "+H")) *att_on mask |= HIDDEN; 
else if (sub str(att_string, "-H")) *att_off mask &= RIDDEN; 


if (sub_str(att_string, "+S")) *att_on_mask |= SYSTEM; 
else if (sub_str(att_string, "-S")) *att_off mask &= SYSTEM; 


if (sub_str(att_string, "N")) *ask = FALSE; 
else task = TRUE; 


/* Returns beginning position of second string in first string 
or zero if second string is not a substring of first. Case 
insensitive. */ 

int sub_str(main string, sub_string) 


char *main_ string, *sub string; 


{ 
int pos, len main, len_sub; 
len _main = strlen(main_string); 
len_sub = strlen(sub_string); 
if (len_main < len sub) return 0; 
for (pos = 0; pos < len main-len_subtl; post+) 
if (xstrcomp(main_string, sub_string,pos,len_sub)) return pos+l; 
return 0; 
} 
[+—-—_-——------——- XSTROOMP. ———--—--—--- -——----—----#/ 
/* Compares "sub string” substring in "main string" starting 


at "start_pos" with a length of "length". Case insensitive. 
x 


int xstrcomp(main_ string, sub string, start_pos, length) 


char *main string, *sub_string; 
int start_pos, length; 


{ 


int i: 


for (i = start_pos; i < start_postlength; i++) 


if (toupper(*(main_stringti)) != toupper(*sub_stringt+)) return 0; 


return 1; 
} 


i KS OOO */ 

/* Concatenates "first" string followed by "second" and puts result 
in "new" string. 

sf 

void concat(new, first, second) 


char *new, *first, *second; 


{ 
while (*first |= (char) NULL) *newtt+ = *first++; 
while (*second != (char) NULL) *newt+ = *second+t; 
*new = (char) NULL; 
} 
[ans TASTIER Sar =a 
/* Returns the last (non-null) character of a string 


*/ 


char lastchar(string) 


... listing continued 


Discover the power of C! 


Use FOR_C™ to convert standard FORTRAN-77 (with MIL-STD- 
1753 and common FORTRAN-77 extensions) into ANSI C with 
great speed and ease of use. 


¢ Produces read- 
able, maintainable 
code with precise, 


©99+% conversion ° FOR_C™ generates 
rate on standard 
FORTRAN-77 

* Translate code 


C-style prototypes 
and checks your 
FORTRAN source and accurate 

for consistent translations 

usage, allowing you ¢Includes C 

to customize func- SOURCE to all 

tion calls in C. This run-time libraries — 
results in the best now acomplete 

and most concise C solution to your 
code possible portability problems! 
Simply the best FORTRAN to C translator available — at any price! 


Order your copy today! 
Introductory Offer: $650°ms-pos 


AFTER MAY 1, 1988: $750.00 
Package includes six months’ free support and upgrades 


COBALT BLUE 


1683 Milroy * Ste 101 * San Jose * CA 95124 
(408) 723-0474 


between PC’s and 
mini-computers 

® Utilize a built-in, 
C-like preproces- 
sor for easy code 
customization 


SERIES 32000 MODULA-2 COMPILER 
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Program development system for Series 32000 based embedded systems running on IBM-PC/XT/AT and PS/2-30 


Description: 


- Add-in board consisting of Series 32000 chip set and ROM-resident 
EDITOR, COMPILER, LINKER, DECODER and MAKE UTILITY 


Host Hardware: 


- IBM PC/XT/AT or compatible with free half card slot 


Host Software: 
- DOS 2.0 or later 


Target Hardware: 


- Any Series 32000 based embedded system 


Target Software: 
- Runtime support is supplied in source form 
Key Product Features: 


- This compiler enables you to use all the features of Modula-2 as described 
in Nicklaus Wirth's Programming in Modula-2 (3rd edition). 


The target runtime support module, supplied in source form, includes a 
floating point package which emulates the NS3208 | chip, if necessary. 


- The system's command-line-based user interface is on-screen supported 
and leads the user through the command entering process. 


‘The information display makes constant reference to a manual unnecessary 
by providing the user with the information needed to run the system. 


Only a single command line is needed to convert a set of source modules 
into an executable file 


- Any individual application can consist of up to 400 modules written 
entirely in Modula-2 
Key Product Benefits: 


~ Manual-free use 


- Programs can be written entirely in Modula-2 

- Easy handling of very large program packages 

~ Convenient transfer of Modula-2 programs written for other processors to 
Series 32000 environment 


- Reasonably priced development system for the entire family of Series 
32000 microprocessors 


Product Vendor: 
Alois Schénbiichler, Freischiitzgasse 14, CH-8004 Ziirich/Switzerland 


Tel,: 41-1-241-0514 
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need the full path name. Thus we need the function 
getpath( ), which is called in line 185. This function does two | 9339, char *string: 
things: (1) It copies the path name (without the file name) : 


into a character array called path{ ], and (2) it then returns 0334: { 


0335: 


the position of the last backslash in this array. Thus, at a 0336: return string[strlen(string)]: 

later time, the file name from each search call can be concat- poli 

enated to the path name. If there is no path name, then 0339: 

getpath() returns a —1. el [to-—-—aa nanan == GBIPATY -===---= === -=—-------——-4/ 
Finally, we can use the search first function to find the a ee oe ee ee ee a a ce 


first file that matches our file specification. Naturally, AH 0343: position of last backslash. If no path name (default directory) 


contains the function number (45 hex in this case) and | fit; {TLD stl tie ttle sesitin Wie 8 
DS:DX points to the full path name. Also, the CX register 0346: subdirectory; hence the test for :. 

contains the attribute mask; only those files whose oP */ 

attributes match the set bits will be found. These bits are 0349: int getpath (argvs, path) 


defined in lines 73-77. If a matching file is found, the carry 0350: 


flag will be reset. ee ee 
As long as the carry flag is not set, we will continue per- 0353: { 

forming the functions pfname() and possibly change_- | jt enka iy s 

att(). Function pfname() takes the file name from the 0356: int bslpos = -1; 

structure filled in by search and appends it to the path name sl dieclit cp BexcccandSi Ie ER ils. kal 

in path{ ]. We can then do what we wish with this file in | 355; “Se (en mow tien *0) belnoe «Ls 


path{ ] (in this case displaying and possibly changing the 0360: 


. 0361: if (bslpos != -1) for (i = 0; i <= bslpos; itt) path[i] = argvs[i]; 
attribute). = “ 0362: return bslpos; 
After we are done with the first file, we search for addi- 0363: } 
tional files using the search next function. Note that this no PE ee 
function needs no parameters—it depends upon the in- 0366: 


formation in the DTA filled by the search first call. The 0367: /* Puts file name (from dmabuf.fname) at end of path (which contains 
A ° ° e 0368: hi . bs i iti f last backslash . 
program keeps searching and filling in the path name until | 39, 4)" PROS ** Position of last bac 


no more files are found (carry set). Once finished, it goes on 0370: 
+ : 0371: void pfname (path, fname, bslpos) 
to examine the next argv/i]. oa, 


Almost any program manipulating multiple files can be 0373: char *path, *fnane; 


implemented in this manner. The body of the program is pets int bslpos; 


really lines 213-218 (along with line 149 and some of the | 9376: ; 


define statements). I have written a program that will print poli acetal a 
multiple files by just replacing lines 213-218 with a call toa | 379: void display type(): 


print routine. 0380: 
0381: j= bslpos !=-1 ? bslpos+l : 0; 
* 0382: for (i = 0; (ch = fname[i]) != (char) NULL; it+, j++) path[j] = fname[i]; 
Using Other Interrupts 0383: path(4] = (char) NULL: 
} 


The systnt() call has been used for MS-DOS interrupts and | {it 


can be used for other interrupts as well. Ihave used itin this |  o3se: 
program to print strings since the C function fputs() is in- | 03878 [t-mmmmrrmmmnmmmm— CHRNGE,_ATE aman | 


q . 0388: 
credibly slow (see the functions Spe() and echo() ). One 0389: /* Changes attribute of file after query (unless "ask" is FALSE). 


other important example is using interrupt 10H, the IBM 0390: No change if subdirectory 
. . . st 
screen-handling interrupt. This allows you to set the cursor | [3): “/ 
position, print characters with attributes such as blink and 0393: void change _att(fullname, att, att_on mask, att_off mask, ask) 


reverse, and even do simple graphics. An example of using pe arta aie, ice cai ee ati 


interrupt 10H is shown in the function cursor_col(). 0396: int ask; 
To set the cursor, we must first get the current active 0397: 
page. Calling INT 10H with AH = 15 (decimal) will return | fies; ‘tatic char ansver: 
with the BH register containing the current active page. 0400: char input (): 
The page number is saved and then we get the current | fit)! Wigeawa ie. 
cursor position. I do this because I want to change the col- | 0403: static int carryf; 
umn only and leave the row as is. With AH = 3 andBH = | te aoe) ( 
desired page, INT 10H will return the cursor position row in | g4¢: fet" Change? *)3 
DH and the column in DL. Line 555 then changes DL only 0407: do { ; 
and calls INT 10H with the new cursor position in the DX | fits: reprise /* abort if *C */ 
register and the desired page in the BH register. 0410: } 
I hope this discussion has shown you how to use MS-DOS | fli: witle ((tompper (answer) eX"), 66: (toupper (answer) Jo°"R:1)7 
calls in general and how to use them from C in particular. [7] | 043: echo (answer); 


0414: } 
a ‘ . 0415: else answer = ‘Y'; /* force change without asking */ 
Mark Zeiger is a product manager for Osicom Technol- | qu: = 3 


ogy, an OEM for computer products based in Rockaway, | 411: if (toupper(answer) == 'Y") { 


0418: inr.ax = SETMODE; 
New Jersey. 0419: inr.cx = att | att_on_mask; 
0420: inr.cx = (inr.cx & att_off_mask) & Ox00ff; 
All the source code for articles published in Micro/Sys- | }#: an eo Cena i) [Sa ey 
5 fs ‘ : carryf = sysint(MSDOS, sinr, soutr); 
tems is available on an MS-DOS disk. To order, send $14.95 | 23: if ( (carryf & CARRYF) == CARRYF) state err(outr.ax); 


to Micro/Systems, 501 Galveston Drive, Redwood City,CA | 4: 1 | 

94063; or call Tim at (415) 366-3600. Please specify the | “°° 8"): 

issue number. Source code is also available on Compu- ... listing continued 
Serve; type GO DDJFORUM. 
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you some 


out 


programming 
tions, they keep you bolted to your seat writing mountains of tedious 


code. And rewriting it all over again with 


every design change 
Imagine how much faster you'd be if you could replace the painful 
coding phase with an innovative visual technology which takes only a 
fraction of the time: Introducing Magic PC—the revolutionary Visual 
Corporation: 


Database Language from Aker 


¢ High-Speed Programming: 

With Magic PC’s visual design language you quickly describe your 
programs in non-procedural Execution Tables. They contain compact 
programming operations which are executed by Magic PC’s runtime 
engine. You fill-in the tables using a visual interface driven by windows 
and point-and-shoot menus. One table with 50 operations eliminates 
writing more than 500 traditional lines of code. Yet with Magic PC you 
don’t sacrifice any power or flexibility. 


MAGIC Pc 
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; 
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With a powerful set of bigh-level non-procedural operations you 
program at only a fraction of the time. 


¢ Maximum Power AND Simplicity: 

With Magic PC, you can generate robust DBMS applications includ- 
ing screens, windows, menus, reports, forms, import/export, and much 
more! Plus, Magic PC has one of the friendliest user interfaces you've 
ever seen. Using Magic PC you can look-up and transfer data through 
a powerful Zoom Window system. Magic PC even lets you perform 
command-free queries. 


¢ Btrieve Performance: 

Magic PC incorporates Btrieve, the high-performance file manager 
from SoftCraft. This gives you exceptional access speed, extended data 
dictionary capabilities, and automatic file recovery! 


¢ Virtually Maintenance-Free: 

With Magic PC you can modify your application design “‘on the fly” 
without any manual maintenance. Magic PC automatically updates 
your programs and data files on-line! This also makes Magic PC an 
ideal tool for prototyping complete applications in hours instead of days. 


¢ FREE Networking: 

Magic PC comes complete with LAN features. Develop multi- user 
applications for your LAN with Magic’s file and record- locking 
security levels, 
¢ Stand-Along Runtime: 

Distribute your applications and protect your design with Magic PC’s 
low cost runtime engine. 

¢ All For Only $199: 

Best of all, Magic PC is an unbeatable bargain. For a limited 
time, Magic PC’s price has been reduced to only $199! Yes, this is 
the same Magic PC that normally lists for $695! And Magic PC 
eliminates the need for a separate DBMS, compiler, or applica- 
tion generator. It comes complete with all the tools you need 
to develop your own database applications instantly. 


% smd MasveP 


PARADOX 


A pera iin els 
H \ 


Lo 8 ly 


“‘Magic PC’s data base engine delivers powerful 
applications in a fraction of the time. . . there is 
truly no competitive product:’ 

Victor Wright — PC Tech Journal 


Order Mo 999 
Order Date 99/99/99 


Customer No 99999 
Address AAA 


In Stock -999.9) 
Total Orders -999.999 
Avall to Sell -999.999 


Pop-up Zoom Windows run multiple programs per screen — with 
point-and-shoot data transfer between windows! 


¢ $199 — With A Money-Back Guarantee! 
For a limited time, you can get Magic PC for only $199. 
And even at this low price, Magic PC is risk-free. If you’re not 
completely satisfied, simply return it within 30 days and we'll 
buy it back (less $19.95 restocking fee). And if you’d like a 
preview, Magic PC’s Tutorial Demo is available for just $19.95. 
But you’d better hurry — Magic PC’s special $199 price 
won't last long! 
e Join The Magic PC Revolution 
To unleash your DBMS design power, order your $199 copy of 
Magic PC right now by calling toll-free or returning the coupon below. 


ORDER NOW: CALL 


(800) 345-MAGIC 
In CA (714) 250-1718 


MAGIC PC 
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Yes! | want Gor ze 
to generate powerful re 


applications much faster! 
OD Rush me my copy of Magic PC at the special promotional price 
of $199 (add $10 P&H, and tax in CA Intemational orders add 
$30). I understand I can return Magic PC for a refund within 30 


, days, if I'm not completely satisfied. * 


! 

! 
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' 
OC Rush me a copy of Magic PC Tutorial Demo at $19.95 (add $5! 
P&H, and tax in CA Intemational orders add $15). 
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Copan? —_$_-_______- Phone 
Street Address (no POB) 
city _______ State Zip 


1 Check enclosed Charge to my: CREE C3 —— 0 


Sysem IBM PC, XT, AT, PS/2 or 100% compatible with 512K RAM, hard disk and DOS 
2.0 or later. 514” format, not copy protected. Dealer pricing available *Retum policy valid in US only. 
Aker, Magic PC, The Visual Database Language are trademarks of Aker Corporation. All other 
trademarks acknowledged. © Copyright 1987, Aker Corp. 


Try MAGIC PC: “#=kiew 
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THE ULTIMATE DBMS Power ~ 


ia es ie herp engi aaricwmemelar age Allee 
line after line of time-consuming code. Most DBMS’ and 4GI’s give 
power. But when it comes to serious applica- 


0426: } 

0427: 

1: SE 
0429: 

0430: /* States error returned in AX register after change attribute call. 
0431: © Will abort if no file or incorrect path, since this indicates 
0432: == program can not start. Will not abort on "Access Denied", since 
0433: this can happen with subdirectories. 

0434; */ 

0435: 

0436: void state err(rax) 
0437: 

0438: unsigned rax; 

0439: 

0440: { 

0441: void fpe(); 

0442: 

0443: rax = rax & Ox00ff; 
0444: 

0445: if (rax == NOFILE) fpe("\nFile not found\007"); 

0446: if (rax == NOPATH) fpe("\nPath not found\007"); 

0447: if (rax == NOACCESS) fpe(" Access denied\007"); 

0448: 

0449; if ( !( (rax == NOFILE) || (rax == NOPATH) || (rax == NOACCESS) }) ) 
0450: fpe("\n\007Undefined error"); 

0451: 

0452: if (rax != NOACCESS) { 

0453: fpe("\n"); 

0454: exit (1); 

0455: } 

0456: } 

0457: 

0458: 

0459: /#--------------------------- BAD_SYNTAX ------------------------- +/ 
0460: 

0461: /* Indicates command line error and shows correct syntax 

0462: */ 

0463: 

0464: void bad syntax() 

0465: 

0466: { 

0467: void fpe(); 

0468: 

0469: fpe("\nIncorrect syntax\007"); /* 361 is octal for +/- */ 
0470: fpe("\n\nUsage: chmod [\361R | \361S | \361H] file file...\007"); 
0471: fpe("\n\n\361R = R/O on/off"): 

0472: fpe("\n\361S = SYSTEM on/off") ; 

0473: fpe("\n\361B = HIDDEN on/off\n"); 

0474: fpe("\nN = change without asking"); 

0475; fpe("\nControls may be strung together (N must not come first)"); 
0476: fpe("\n i.e. +R-HN+S or -S+RN"); 


/* isolate AL register */ 


0477: fpe("\n\nI£ no control, then file attributes are displayed only\n"); 


0478: exit(1); 

0479: } 

0480: 

0861s. [8 ———-——-n nano DISPLAY TYPE ——== 8 / 
0482: 

0483: /* Displays attribute of file. Called from pfname() which gets 
0484: ~~ attribute from dmabuf.attribute. 

0485: */ 

0486: 

0487: void display type(att) 

0488: 

0489: char att; 

0490: 

0491: { 

0492: void fpe(), cursor _col(); 

0493: 

0494: cursor_col (30); 

0495: 

0496: if ( (att & 0xlf) == 0) fpe("NORMAL "); 

0497: else { 

0498: if ( (att & RO) == RO) fpe("READ/ONLY "); 

0499: if ( (att & HIDDEN) == HIDDEN) fpe ("HIDDEN "); 

0500: if ( (att & SYSTEM) == SYSTEM) fpe ("SYSTEM "); 

0501: if ( (att & VOLUME) == VOLUME) fpe ("VOLUME "); 

0502: if ( (att & SUBDIR) == SUBDIR) fpe("SUB DIRECTORY "); 
0503: } 

0504: } 

0505: 

0506: /*-----—----—_—_—_—_—---- FPE --——--——------—_--—---___-——--_—-t/ 
0507: 

0508: /* Prints string using MS-DOS console I/0 function. This is 
0509: because fputs() library function is incredibly slow. Also 
0510: tests for console input and pauses if any key is pressed. Will 
0511: resume when any key is pressed again. 

0512: */ 

0513: 

0514: void fpe(string) 

0515: 

0516: char *string: 

0517: 

0518: { 
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0519: static char ch, chl; 


0520: 

0521: while ( (ch = *stringt+) != (char) NULL) 

0522: if (ch l= '\n') echo(ch); 

0523: else { 

0524: echo("\015"); /* ASCII CR */ 
0525: echo(ch); /* now do the LF */ 
0526: } 

0527: 

0528: if ( (chl = input()) != (char) NULL) 

0529: if (chl == 3) exit (1); 

0530: else while ( (chl = input()) == (char) NULL) 
0531: if (chl == 3) exit(1); 

0532: } 

0533: 

0534; /*--——-—--------—-—-—= CURSOR COL --—------=—--—----—---—-#/ 
0535: 


0536: /* Places cursor at colum "col" of current line using BIOS 
0537: int 10h */ 

0538: 

0539: void cursor_col(col) 

0540: 

0541: int col; 

0542: 

0543: { 

0544: struct REGS inreg, outreg; 

0545: static unsigned current_page; 

0546: 

0547: inreg.ax = CURR VIDEO; /* gets active page in BH register */ 
0548: sysint (VIDEO INT, sinreg, soutreg); 

0549: current_page = outreg.bx; 


0550: 

0551: inreg.ax = READ CURSOR; /* read cursor position to get row */ 
0552: inreg.bx = current_page; 

0553: sysint (VIDEO_INT, sinreg, soutreg) ; 

0554: 


0555: inreg.dx = (outreg.dx & Oxff{00) + (col & Ox7£); /* leave row */ 
0556: inreg.bx = current_page; /* alone and */ 
0557: inreg.ax = SET_CORSOR; /* .put cursor in col */ 
0558: sysint (VIDEO_INT, sinreg, soutreg) ; 

0559: } 

0560: 

0561: 

6a: ——$—$$—$<$<— $$$ Ir -————_——_—___--——————_———++/ 
0563: 

0564: /* Will return NULL if not character ready, or character. Does not 
0565: wait for input. Uses MS-DOS function AH = 6 for raw console I/0. 
0566: Can not be used for function key input. 

0567: */ 

0568: 

0569: char input () 

0570: 

0571: { 

0572: struct REGS inreg, outreg: 

0573: static int zerof; 


0574: 

0575; inreg.ax = CONIO; 

0576: inreg.dx = 0x00ff; /* input subfunction */ 
0577: zerof = sysint (MSDOS, ginreg, soutreg) ; 

0578: if ( (zerof & ZEROF) == ZEROF) return (char) NULL; 
0579: else return (char) outreg.ax; 

0580: } 

0581: 

0582: /*-—-—_—___—-—— — ECHO -----------——----—----- === -———-—-—-t / 
0583: 

0584: /* Echos character to console using MS-DOS function AH = 6 
0585: */ 

0586: 

0587: void echo(ch) 

0588: 

0589: char ch; 

0590: 

0591: { 

0592: struct REGS inreg, outreg; 

0593: 


0594: inreg.ax = CONIO; 

0595: inreg.dx = (unsigned) ch; 
0596: sysint (MSDOS, sinreg, sovtreg); 
0597: } 

0598: 


End of Listing 2 
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There is only one 
true test for a high performance 
C' compiler....your program 


The most important 
measurement for rating 
your C compiler's 
execution speed is the 
performance of your 
program. C86PLUS' multi- 
pass optimizer concentrates on 
value use anaylsis and register 
selection, as opposed to areas that 
have little or no impact on 
program size or speed except in 
benchmarks. 

With this approach in mind, 
Computer Innovations’ 
C86PLUS v.1.10 is geared for 
large, real world applications 
rather than promotional 
benchmarks, which in many 
cases, do not accurately reflect 
superior code generation. 

And while most compiler 
vendors rely on their benchmark 
claims and lengthy optimization 
listings to sell speed, we're 
relying on what really counts the 
most -- the performance of your 
program. 


C86PLUS has the 
features you need for 
professional-level 
application development. 
The latest proposed ANSI C 
libraries; 80386-specific compiler 
options to take advantage of the 
32-bit architecture while running 
under DOS in real mode; 100% 


ROMable code for embedded 
systems development; a MAKE 
utility; C library source code at no 
extra charge; and FORTRAN, 
Pascal calls. 

Small, medium, compact and 
large memory model support; 
powerful math libraries and inline 
floating point support for 
computation-intensive 
programming; Microsoft C v.4.0 
and UNIX System V 
compatibility for application 


Experience performance 
from a real point-of-view. 
Order now or contact us-for 


portability; powerful support more information. 
tools for increased programmer 
productivity; and the ability to 800-922-0169 


write interrupt routines in C 
rather than assembler. 


COMPUTER 
INNOVATIONS 


980 SHREWSBURY AVE. 
TINTON FALLS, NJ 07724, USA 
TLX: 705127 COMP INNOV UD 

(201) 542-5920 


Support to keep you 
satisfied. Whatever the time or 
problem, we're prepared to help. 
Computer Innovations (CI) offers 
telephone technical support 
during regular business hours, a 
dial-up 24-hr. bulletin board 
service or you can contact us via 
our vendor conference on BIX. 

Should add-on productivity 
products be of concern, 


C86PLUS is supported by most ‘eee 
major third-party vendors and CI 7 US 
resells them for your added 

convenience. CI also offers ® 
products specific to embedded 

systems application development C COMPILER 

and C language training. (call for current pricing and version) 


Minimum System Configuration: Intel 8086/186/286/386-based system running DOS 2.1 or 
above; 384K RAM and a hard disk drive is required.Registered trademarks: Microsoft (Microsoft 
Corp.), UNIX (AT&T-Bell Labs), Intel (Intel Corp.), BIX (McGraw-Hill, Inc.). 


Why puzzle 


when you don’t 


Micro/Systems Journal has the answers. that M/S/ is famous for 
Whether it’s networking, systems integration, providing .. . in-depth 


programming, or scientific computing tutorials, reviews, hints, the 

questions, M/S/ will lead you out of the maze latest on multitasking, languages 

of microcomputer mayhem. With each issue and operating systems. So stop your 

you'll find comprehensive coverage of all the puzzling . . . subscribe right now and the answers 
technical information that will keep you will be yours. Simply drop the attached card 
up-to-date with the ever-changing microcom- in the mail—that’s all there is to it. 


puter industry. You'll get the hands-on, nuts 
and bolts information, insight, and techniques 


Software Review 


Turbo C 1.5 versus 


Quick C 1.0 


' hy so much excitement 


among C users over two new C compil- 
ers? It’s not as if we haven’t had C 
compilers before. They have been 
abundant since the days of CP/M. 
Small-C compilers have even been in 
the public domain, available to all for 
the price of a magazine. What makes 
these two products so different from 
the rest of the pack is their integration 
of editor and compiler into a combined 
development environment. From this 
environment, the programmer can find 
errors, correct them, and test the re- 
sulting program at a rate unapproach- 
able with conventional compilers. 

Borland started the practice with 
Turbo Pascal back in the early days of 
the PC. Turbo Pascal was essentially a 
small, very fast compiler that could 
generate, if not outstanding, at least 
reasonable code, molded together with 
a WordStar-like program editor. 
Turbo Pascal had several serious limi- 
tations: it understood only one mem- 
ory model; it couldn’t generate pro- 
grams larger than 64K; and it couldn’t 
be linked with other languages. Still, 
Turbo Pascal was a wild success. Pro- 
grammers fell in love with the ease of 
use inherent in such a combined pro- 
gramming environment. 

While Turbo Pascal was incremen- 
tally improved over the years, it was 
quite some time before the next inte- 
grated language appeared. Turbo C 
didn’t appear on store shelves until the 
summer of 1987, followed only a few 
months later by Microsoft’s version of 
the same thing, Quick C. How are 
these two “newest generation’ com- 
pilers similar? What differentiates 
them from each other? 

Table 1 compares the features of the 
two compilers. We will start by examin- 
ing Turbo C 1.5. Then, due to the large 
number of similarities between this 
compiler and Quick C, we will point out 


Aprit 1988 


by Stephen R. Davis 


only the important differences in Quick 
C, Finally, I will draw some admittedly 
subjective conclusions. 


Turbo C 1.5 
Turbo C is somewhat intimidating 
when you first open the package, espe- 
cially if you are expecting it to be at all 
like Turbo Pascal. Tucked away within 
the shrink-wrapped manuals are five 
floppy disks. Although one contains 
nothing but examples, the combined 
package still consists of 834K of exe- 
cutable files, plus 100K of include files 
and 700K of object libraries. Since 
Turbo C itself makes up only 240K of 
that, and since not all of the object li- 
braries are necessary at any one time, 
operation from 360K floppy disks is 
still just possible. Once you get beyond 
the size, actual installation of the pack- 
age runs quite smoothly. A special in- 
stall program allows the user to specify 
screen colors, adapter type, and editor 
commands. In addition to normal 25- 
line mode, Turbo C supports 43-line 
mode on EGA and 50-line mode on VGA 
adapters. (I found these modes too 
ragged to be easily readable.) 
Especially useful is the ability to 
specify directories for each of the dif- 
ferent support file types. For example, 
suppose Turbo C itself were located in 
C:\TURBOC. Rather than lump the 
whole package together, the user 
might prefer to place the include files 
in C:\TURBOC\INCLUDE and the .LIB 
library files in C:\TURBOC\LIB. The 
user simply supplies these directory 
names to Turbo C, and the compiler 
does the rest. If desired, these directo- 
ries can be divided further, with the 
small model libraries in LIB\SMALL, 
the medium model libraries in LIB\- 
MEDIUM, and so on. Turbo C allows a 
list of directories to be specified, and 
each directory is searched in turn until 
the desired file is found. 


Turbo C allows the user to specify a 
working directory, where target and 
temporary files are stored. This ca- 
pability allows the user to direct Turbo 
C to use a RAM disk, if available, as the 
temporary storage device—an advan- 
tage that leads to impressive increases 
in compilation speed. This capability 
also keeps temporary files from clut- 
tering up the user’s source directory. 

Just as with Turbo Pascal, the 
Turbo C editor can be reinstalled for 
any commands desired. The default is 
for the WordStar command set plus 
another, more mnemonic, set of syn- 
onyms. For example, depressing the 
right arrow key might be somewhat 
more obvious than ~D. No macro ca- 
pability exists for defining editor com- 
mands that do not already exist. 

Once Turbo C is installed, it’s ready 
for use. The Turbo C environment is 
very menu-oriented. Single key “short 
cuts’’ exist for many of the command 
sequences, but the drop-down menus 
are so fast and obvious, there seems 
little reason to memorize them. Con- 
text-sensitive help is available at al- 
most every turn. This help is not of the 
all-encompassing, “replace the man- 
ual’ variety, however. 

By selecting the Open selection of 
the File menu, the user may pick any 
of the C files in the current directory, 
either by pointing or by entering its 
full name. The File menu also allows 
the user some simple DOS commands, 
such as changing subdirectories. 

Interestingly, Turbo C maintains 
what is known as a Pick file. Every 
time a file is edited, Turbo C remem- 
bers the tab settings, any marked 
blocks, and the last position within the 
file. As soon as the user brings up 
Turbo C, it automatically loads the last 
file worked on and places the user at 
the last edit. The effect is to further 
enhance programmer speed. 
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Introducing 


“Disk Cache for the IBM PC"’ 


Make your floppy drive and 
hard disk run close to RAM disk 
speeds. Dramatic speed improve- 
ment for most programs. Supports 
cache of any size in main or ex- 
panded memory. 

Requires IBM PC/XT/AT or true 
clone. 


only $29.95 


“multitasking for the IBM-PC.’ 


Ideal for developing applications 
in process control, data acquisi- 
tion, communications, and other 
areas. Check these features which 
make MultiDos Plus an unbeat- 
able value. 


Run up to 32 DOS programs con- 
currently. 
Operator commands to load/run 
programs, change priority, check 
program status, abort/suspend/ 
resume programs. 
Programmatic interface via INT 15H 
for the following. 
Intertask message communi- 
cation. 
Task control by means of 
semaphores. 
256 priority levels. 
Suspend task for specified 
interval. 
Spawn and terminate external 
and internal tasks. 
Disable/enable multitasking. 
and more! 


Requires IBM PC/XT/AT or true 
clone, and enough memory to hold 
MultiDos Plus (48 KB) and all your 
application programs. 


$24.95 »« $99.95 


With source code 
(Written in Lattice C 
and Microsoft Assembler.) 


Outsitle USA add $5.00 shipping and handling. 
Visa and Mastercard orders only call 
toll-free: 1-800-872-4566, ext. 350., or 
send check or money order (Drawn 
on U.S. Bank Only) to: 


NANOSOFT 


13 Westfield Rd, Natick, MA 01760 
MA orders add 5% sales tax. 
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As noted, the editor itself is 
WordStar-like in both its command set 
and its style of operation. Anyone fa- 
miliar with the Turbo Pascal editor will 
feel right at home here. There are 
three additions worthy of note, how- 
ever. First, the curious operation of 
the Tab key is now optional; under 
Turbo C, the Tab key can be made to 
tab over to user-selectable tab posi- 
tions. Second, a new “pair matching” 
command has been added to help sort 
out parentheses, braces, and com- 
ments; the user places the cursor on a 
{, for example, depresses “‘pair 
match,” and the editor instantly jumps 
to the corresponding }. Finally, a “go 
to previous/next error’”’ command has 


been added and is quite convenient for 
moving from one compilation error an- 
other in order to quickly sort out com- 
piler problems. 

The compiler is also accessed from a 
pull-down window. The Turbo C com- 
piler is completely compatible with the 
Kernighan and Ritchie implementation 
of C. In addition, Turbo C follows most 
of the ANSI draft standard, including 
function prototyping, enumerated data 
types, the VOID data type, the VOLA- 
TILE and CONST specifiers, and stron- 
ger typing. 

Both in its library and in its language 
extensions, Turbo C tries very dili- 
gently to be upward-compatible with 
Microsoft C Version 4.0. Turbo C sup- 


Table 1—Comparison of Quick C 1.0 and Turbo C 1.5 features 


Interface 
interface 
interactive via keyboard 
interactive via mouse 
command line 
43-line EGA/50-line VGA 
user-installable colors 
built-in debugger 
help 
context-sensitive 
all-inclusive 
available from command line 
pick files supported 
Language 
full Kerningham and Ritchie 
ANSI proposed standard 
Pascal fn. passing rules supported 
case-insensitivity at link 


pseudo-variable access of registers 


assembly language output 
inline assembly language 
direct video text output w/printf 
memory models 
interactive 
command line 
mixed memory modes allowed 
declarations 
interrupt procedure 
volatile const variables 
register variables 
double 
long 
Editor 
support WordStar commands 
support mnemonic commands 
commands redefinable 
Undo available 
next/previous error 
go to specific error 
tab size selectable 
autoindent 
autosave 
print command 
pair matching 


Quick C Turbo C 
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ports six memory models: small, me- 
dium, compact, and large, plus tiny and 
huge (tiny being similar to small with 
combined data and code segments, and 
huge being a special large memory 
model that allows arrays larger than 
64K although at some cost to speed). 
Turbo C supports mixed memory 
model operation via NEAR and FAR 
pointer declarations of pointers and 
functions, independent of the default 
memory model. An additional function 
type, INTERRUPT, allows program- 
mers to write interrupt and terminate- 
and-stay-resident (TSR) programs eas- 
ily in Turbo C. 

Turbo C can optionally generate 
80186/286 real-mode instructions for 


machines that can handle it, and can 
utilize the 8087/287/387 floating 
point processor, if available. Even 
when present, Turbo C-generated pro- 
grams can be instructed to ignore the 
floating point processor. This feature 
is highly desirable when testing float- 
ing point software. 

Although it isn’t obvious with simple 
programs, Turbo C’s Compile com- 
mand is actually a complete “make.” 
When the user selects Compile, Turbo 
C compares the creation time of the 
object file with the time of the last 
source file edit. If the edit is more re- 
cent, Turbo C updates the object by 
compiling it. More complex dependen- 
cies, such as in multiple module pro- 


Quick C TurboC 
Compiler 
operation 
number of passes 1 1 
compilation speed [lines per min.] 10,000 >7,000 
generates stand-alone .EXE Y Y 
links with other languages Y Y 
8087 support 
run-time sense Yi ay: 
deselectable N 3 
80186/286 instructions x Y 
warning levels 
user-selectable Y Y. 
independently controllable N Y 
degree of compiler control some great deal 
output-controllable Y Nt++++ 
debugger support 
Codeview Y N 
other source code debuggers ¥ Y 
SIEVE benchmark time *** 4.7 3.9 
Miscellaneous 
MAKE from command line and environment Y, Ni 
LINK 
from command line and environment y i 
support overlays y N 
object .LIB librarian x Y 
graphics support library Y yy. 
library source code available Y ($150) YY ($150) 
memory recommended 448K 384K 
floppy operation possible y. Ve 
price $99.00 $99.95 
+ = Medium memory model only 
++ = Tiny, small, compact, medium, large, and huge 
memory models 
+++ = Small, compact, medium, and large memory models 
++++ = Turbo C always sends output directly to disk; this may 
be redirected to a RAM disk, if available 
* = command line version only 
** = not documented 
*** — time in seconds for 10 iterations of Byte Sieve on a 7.6 
MHz IBM PC with all optimizations enabled under 
medium model 
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COMBINE THE 
RAW POWER OF FORTH 
WITH THE CONVENIENCE 
OF CONVENTIONAL LANGUAGES 


HS 
FORTH 


Yes, Forth gives you total control of your 
computer, but only HS/FORTH gives you 
implemented functionality so you aren't left 
hanging with “great possibilities” (and lots of 
work!) With over 1500 functions you are 
almost done before you start! 
WELCOME TO HS/FORTH, where megabyte 
programs compile at 10,000 lines per minute, 
and execute faster than ones built in 64k 
limited systems. Then use AUTOOPT to 
reach within a few percent of full assembler 
performance — not a native code compiler 
linking only simple code primitives, but a full 
recursive descent optimizer with almost all of 
HS/FORTH as a useable resource. Both 
optimizer and assembler can create inde- 
pendent programs as well as code primitives. 
The metacompiler creates threaded systems 
from a few hundred bytes to as large as re- 
quired, and can produce ANY threading 
scheme. And the entire system can be saved, 
sealed, or turnkeyed for distribution either on 
disk or in ROM (with or without BIOS). 
HS/FORTH is a first class application devel- 
opment and implementation system. You can 
exploit all of DOS (commands, functions, 
even shelled programs) and link to .OBJ and 
.LIB files meant for other languages inter- 
actively! 

\/O is easier than in Pascal or Basic, but much 
more powerful — whether you need parsing, 
formatting, or random access. Send display 
output through DOS, BIOS, or direct to video 
memory. Windows organize both text and 
graphics display, and greatly enhance both 
time slice and round robin multitasking utili- 
ties. Math facilities include both software and 
hardware floating point plus an 18 digit 
integer (finance) extension and fast arrays for 
all data types. Hardware floating point covers 
the full range of trig, hyper and transcenden- 
tal math including complex. 

Undeniably the most flexible & complete 
Forth system available, at any price, with no 
expensive extras to buy later. Compiles 79 & 
83 standard programs. Distribute metacom- 
piled tools, or turnkeyed applications royalty 
free. 


HS/FORTH (complete system): $395. 
HS/FORTH: Tutorial & Ref (500 pg) $ 59. 
Forth: Text & Reference (500 pg) $ 22. 
HS/FORTH Glossary $ 10. 
GIGAFORTH Option (Beta release) $245. 
(Native Mode from SOFTMILLS, INC.) 


aa Visa Mastercard 


HARVARD 
SOFTWORKS 


PO BOX 69 
SPRINGBORO, OH 45066 
(513) 748-0390 
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Programmer's 
Power Pack 


ow you can reach 100,000 
programmers, consultants, 


and systems integrators with your 


Fack card deck targets this elite audi- 
ence, including subscribers to Dr 
Dobb's Journal of Software Tools, for 


only a little over a penny a contact! 


The Programmer's Power Pack 
Card Deck 


Next Mailing Date: July 3, 1988 
Reservation Closing: June 5, 1988 


For advertising rates, card specifications, and 


to reserve your space, contact: 


GLYNN MANSFIELD 
National Account Manager 


415-366-3600 
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postcard ad. The Programmer's Power 


grams, are specified in a separate 
project file. For example, the user may 
specify that a module must be recom- 
piled and the program relinked if an 
include file of a different name is 
edited. The effect is very efficient. 

The same process—comparing the 
creation time of the object to that of 
the executable—is repeated in the link 
step. If any part of the object is newer, 
the program is relinked. By going 
through an explicit link step, Turbo C 
modules can be combined with object 
files of other languages. To facilitate 
this, Turbo C supports two different 
procedure-calling protocols: one for 
“C-type” procedures and another for 
“Pascal-type”’ procedures. In addition, 
Turbo C can be instructed to perform a 
case-insensitive link, treating all let- 
ters as if they were uppercase. (C is 
strictly case-sensitive, but most other 
languages are not.) The resulting exe- 
cutable file may be directed to any disk 
desired, even a RAM disk. Compiling or 
linking directly into RAM is not possi- 
ble, however. 

Turbo C allows a great deal of con- 
trol of the compile/link process. The 
user may select which types of warning 
messages to print, what type of optimi- 
zations to perform, which memory 
model to use, what type of floating 
point, and so on. All of the features nor- 
mally accessed via complex command- 
line switches are accessible from pull- 
down menus. Once made, these user 
preferences may be saved to disk. 

Having created an executable file, 
the user may also choose to run the 
program directly from within the envi- 
ronment. Anyone who has ever lost a 
session of source file edits due to an 
errant program crashing the system 
will appreciate Turbo C’s autosave fea- 
ture, which automatically saves edited 
files to disk before the user program is 
executed. 

Executing programs from within the 
Turbo C environment is a bit of a prob- 
lem, however, since Turbo C has no 
built-in debugger. This omission is dif- 
ficult to understand, especially since 
the absence of a debugger was sorely 
felt under Turbo Pascal. It seems that 
Borland would have been quick to add 
a debugger in Turbo C. Fortunately, 
Turbo C will generate a detailed load 
map. This allows Turbo C-generated 
programs to be used with third-party 
source-code debuggers, such as Peri- 
scope or PFix. Turbo C does not 
directly support the Codeview 
debugger, however. 

I found that I could shell to DOS from 
the File menu and then execute my pro- 
gram under PFix to debug it. Once er- 
rors were found, I simply exited PFix, 
entered EXIT at the DOS prompt and, 
pop, I was back in Turbo C. Although 


this is quick enough, it should not be 
necessary. Borland is rumored to have 
a debugger in the wings and we can 
only hope that it is available by the time 
this article appears. 

For those that require it, a separate 
command-line version of Turbo C is 
available. This version includes all the 
language features of the environment 
version, plus two others: (1) the ability 
to generate assembly language output 
and (2) the ability to include inline as- 
sembly language. These are powerful 
features that come in quite handy, es- 
pecially when debugging Turbo C IN- 
TERRUPT procedures. Complement- 


Turbo C mod- 
ules can be 
combined with 
object files of 
other 
languages. 


ing this command-line version of the 
compiler are command-line MAKE and 
TLINK facilities. One extra utility, not 
available from within the environment, 
allows users to create and maintain 
their own object libraries. Unfortu- 
nately, preferences established and re- 
corded from the environment version 
do not automatically carry over to the 
command line. Instead, users must 
build involved batch files specifying 
chains of switches. Invoking it without 
any arguments prompts the compiler 
to print a summary of all the legal 
switches, making some trips to the ref- 
erence manual unnecessary. 

Like previous Borland manuals, the 
three Turbo C manuals are bound soft- 
backs in the slightly larger, European 
format. While all the information ap- 
pears to be there, Turbo C’s manuals 
are slightly scatterbrained, sometimes 
leaving a subject only to return to it 
several chapters later. 

Unfortunately, Borland did not re- 
vise the Version 1.0 manuals for Ver- 
sion 1.5, choosing instead to add a 
third manual, Enhancements, that de- 
scribes all the improvements and 
changes in Version 1.5 over its older 
sibling. References are made in the 
Enhancements manual to specific 
page numbers in the other two books. 
Unfortunately, some things did change 
in the other manuals, so page refer- 
ences are not accurate. Normally, this 
would be unacceptable in manuals, but 
since most changes between 1.0 and 
1.5 are actually additions, the situation 
is not too bad. 
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Interfacing to S-100/IEEE 696 Microcomputers 
by Mark Garetz and Sol Libes 


i nterfacing to S-100/IEEE 696 Microcomputers provides an 
in-depth look at how the S-100 bus works, and includes concepts 
that are basic to the understanding of most any bus-based system. 
You'll find: 


* aprecise description of the mechanical and functional design of 
the S-100 bus 

logical and electrical relationships 

* bus interconnections and busing techniques 

* descriptions of both parallel and serial interfacing as well as in- 
terfacing to RAM, ROM, and the real world 

* a discussion of digital-to-analog and analog-to-digital 
conversion 

¢ interrupts 

* programmable timer/counters 

« temporary master access and temporary bus masters 

¢ and useful circuits. 


While the examples contained in Interfacing to S-100HEEE 696 
Microcomputers relate specifically to the S-100 bus, the concepts 
presented can help you to expand the utility and power of any bus 
based system. 


To Order: Return this coupon with your payment to M&T Publishing, 
501 Galveston Drive, Redwood City, CA 94063. 
Or, CALL TOLL-FREE 800-533-4372 (in CA 800-356-2002) 


Yes! send me Interfacing to S-100/IEEE 696 


Microcomputers _ $24.95 
CA residents add sales tax _ % 
Shipping __ $2.25. 
TOTAL 
CL] Check enclosed. Make payable to M&T Books. 
Chargemy [] VISA LJ M/C [-] Amer. Exp. 
Card # = - Exp. Date 
Name 
Address a 
City State Zip 
40B 


The Turbo C library is quite exten- 
sive. Borland makes the source code 
available at extra charge. This can be 
useful in a commercial application, 
where the user might want to modify 
the operation of certain library 
routines. Included in the library is a 
graphics manager that supports all of 
the common display adapters including 
VGA, EGA, Hercules, and AT&T. 


Quick C 1.0 

In many respects, Quick C is similar to 
its Turbo C rival. As imposing as 
Turbo C was when opening the box, 
Quick C is even more so. Quick C ar- 
rives encased in two manuals: a bound, 
all-inclusive language description and a 
compact, three-ring binder description 
of the library routines. 

Installation of Quick C onto a hard 
disk or user floppies is performed via 
an install program. Before it can be in- 
stalled, however, users must decide 
several issues with which they may not 
be familiar. As I later found out, chang- 
ing these decisions is not particularly 
difficult but must be performed man- 
ually. Once Quick C is physically resi- 
dent in the machine, no further instal- 
lation is necessary. 


As with Turbo C, Quick C allows in- 
clude and library files to be in different 
directories; however, Quick C exe- 
cutes this by setting labels in the envi- 
ronment. This means that, before run- 
ning Quick C, a batch file must be used 
to set these labels up and these deci- 
sions cannot be changed once in the 
environment. In addition, only single 
directories are allowed. 

Like Turbo C, Quick C is menu-ori- 
ented. Unlike its competitor, Quick C 
supports a mouse interface in a very 
Windows-like fashion. Although opera- 
tion without a mouse is possible, the 
feel is somewhat ‘‘klunky.’’ With a 
mouse, the package really shines. I am 
still no fan of editing with rodents, but 
manipulation of the Quick C environ- 
ment is a dream. Quick C also allows 
single-key combination access to many 
of the commands. Help, available most 
of the time, is not context-sensitive. In- 
stead, it is all-inclusive, with its own 
menu of offerings that even describes in 
some detail individual library routines. 

The Quick C editor uses the Word- 
Star command set in addition to a more 
mnemonic set of commands. In addi- 
tion, many editing functions can be 
performed with the mouse. The Quick 


Documentation 
isa PAIN! 


..- Without DocuMotion™ 


We’ve found that well indexed and easily accessed documentation 
is a powerful tool. Now you can simply pop up DocuMotion to 
access, display and print your documentation or guide reference 
libraries. DocuMotion builds cross indexed document libraries 
from documentation contained in your source code or any text file. 
Version 3 adds great features like: folding documents, cross- 
referencing, 10 book marks, and a context-sensitive help interface. 


DocuMotion is PAINLESS 


IT’S DOWN-RIGHT FUN! 


... for Programmers: 

© Your documentation is available 
ANYWHERE, ANY TIME. 

© Access, display and print your 
documentation by name or by 
user-defined categorization trees. 

® Your choice -- pull-down menus 
or intuitive accelerator keys. 

© Powerful print & copy functions. 


... for Project Managers: 


© Programmers produce more and 
better documentation. 

® Reduced function redundancy. 

© Greater programmer productivity. 


N 
— aantelligent 
Ne lutions, inc. 
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... for the PC: 
© Runs memory resident or non- 
resident on any IBM PC/XT/AT 
or compatible. 
* Compatible with all popular 
memory resident programs. 
° LAN compatible. 
DocuMotion is for YOU: 
Call NOW 1-612-884-5860 


Developer’s System $159.95 


Coming Soon: Reference Guides for 
your favorite tools...CALL. 


We need your expertise for reference guides. 
Any Topic. Liberal royalties...CALL 


P.O. Box 20478 


Bloomington, MN. 55420-0478 


C editor includes all the features of the 
Turbo C editor including autoindent, 
“pair matching,’ block move, and 
print. The editing commands are not 
user-installable. Quick C’s tab is the 
normal variety and the user can select 
the spacing. Quick C’s autoindent fea- 
ture cannot be disabled. Like Turbo C, 
Quick C’s Undo command is limited; 
however, since most deletes go to the 
ClipBoard, inadvertent deletes can be 
pasted back in place without undue 
heartache. 

The Quick C compiler is compatible 
with Microsoft C 5.0. This means that 
it implements the Kernigham-and- 
Ritchie standard and the ANSI draft 
standard extensions. Quick C supports 
the four important memory models but 
supports only the medium memory 
model from within the environment. 
As with Turbo C, Quick C can gener- 
ate 80186/286 real-mode instructions 
and will support a 8087/287/387 float- 
ing point processor. It is not possible 
to deselect the floating point proces- 
sor, if present. 

The Quick C compiler supports a 
built-in make that is much like that in 
the Turbo C compiler. Program lists 
with enumerated dependencies are en- 
tered in a similar fashion. Although the 
user can control the level of warning 
messages and some optimization fea- 
tures, the level of control from within 
the environment is not as high as it is 
with Turbo C. User preferences may 
be saved off, but they are always 
stored in a file called QC.INI in the cur- 
rent directory. 

Quick C may compile to disk, to 
memory, or, in what is known as “‘syn- 
tax check only’’ mode, to the bit 
bucket. Compilations to memory are 
very fast. The excellent debugger built 
into the Quick C environment is a sub- 
set of the Codeview debugger. Com- 
mands are available to single step, set 
breakpoints, and set watch variables. 
The Quick C debugger, especially 
when used with a mouse, simplifies de- 
bugging under the environment many 
fold. It is elegant in feel and operation. 
For those more tenacious bugs, Quick 
C supports Codeview (although it is 
not included). As with Turbo C, a sepa- 
rate command-line version of Quick C 
is available. That supports the memory 
models unsupported by the environ- 
ment version. Otherwise, the compil- 
ers seem identical. 

Also available are command-line 
versions of MAKE, LINK, and a library 
utility. The Microsoft linker supports 
automatic overlay creation and main- 
tenance, an important feature with 
really large programs. 

The Quick C manuals are very well 
written. They are just as notable, how- 
ever, for what they leave out or men- 
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The West Coast Computer Faire 
announces the first 
Computer Matchmaking Service. 


ie won't have to depend on fate at the 
13th West Coast Computer Faire to find the 
products and services that are the perfect 
match for your needs. 

We start you out on your path to high- 
tech bliss with Vertical Market Matching. 
We bring in the companies selling quality 
computers, software, peripherals, and add- 
ons—companies that meet the needs of peo- 
ple involved in specific business segments 
such as finance, medicine, manufacturing, law, 
education, engineering, and construction. 

And our Product Matching makes it 
easy for you to find the software, add-ons and 
upgrades for the Commodore Amiga, Apple II 
or Macintosh, IBM PC/MS-DOS, 
IBM PS/2, Atari, Lotus and more, 
that will keep you happily gazing 
into your current system's eyes. 
Plus, we counsel you on the latest 
techniques and insights in our PA 
outstanding Conference sessions. 4 


_ Register early and save $5! 


The West Coast Computer Faire has 
made and will make more matches than any 
another computer show. It’s time we made the 
perfect match for you. 

Match your interests with these Faire 
Features: 

* Computer Art Gallery 

* Computer Faire Networks 

* Computer Music Demo 

* Computer-Aided Special Effects Demo 

¢ Exhibitor Presentations 

¢ Free Hands-On Classes, including Desktop 
Publishing, MS-DOS, Word Processing, Lotus 
1-2-3 


The West Coast Computer Faire, Moscone 
Center, San Francisco, CA, April 7-10, 1988 


For information on exhibiting, call 
617-449-6600, x5077. But hurry — the 
Faire’s floor is almost full! 


Name 


Company 


Fill out this coupon and mail with your check(s), for $15.00 for each registrant, postmarked by March 17th, 
1988. Include the names and addresses of registrants for whom you are enclosing a check. (Photocopy coupon for 
additional registrants.) 


Address _ 


City 


Phone ( ) _ 


Four day conference and exhibits $15.00 in advance. $20.00 at the door. Make check payable to “The West 
Coast Computer Faire.’ Mail to: Attendee Registration Department, The West Coast Computer Faire, 300 First 
Avenue, Needham, MA 02194. Advanced registrations accepted only with full payment and each registrant's name 
and address. Tickets will be mailed to each individual registrant separately. 


aE 13m WEST COAST 


(COM? WER] MESTRIE April 7-10, 1988, Moscone Center, San Francisco, CA 


tion only briefly as for what they con- 
tain. For example, the fact that the in- 
teractive version of Quick C supports 
only the medium memory model is 
buried about as deeply as humanly pos- 
sible. Several features supported in 
Quick C (for example, INTERRUPT 
procedures) are not mentioned at all. 

All this leads to the fact that 
Microsoft has a problem. Microsoft 
claims that Quick C is 100% Micro- 
soft C 5.0 compatible,”’ which means it 
must support 5.0 features whether the 
manual mentions it or not. In fact, the 
object libraries for Quick C are exactly 
the same as the ones provided with C 
5.0. What, then, is the incentive to 
purchase the 5.0 package for roughly 
four times the price? Unfortunately, 
not documenting certain features in 
order to make them appear absent, as 
well as arbitrarily limiting the interac- 
tive version to one memory model, 
might provide such a buying incen- 
tive—even when the software itself 
does not. 


Conclusions 
Performance of the two compilers is 
similar. Both compile quickly, generat- 


Conquer Time 
and Space. 


Introducing XO-SHELL. 


ing reasonably efficient code. The time 
difference in executing the sieve of 
Eratosthenes is due primarily to Turbo 
C’s register optimization—Quick C 
showed little or no register optimiza- 
tion and ignored the REGISTER direc- 
tive when present. 

I could not come up with a clear 
pick. Had Turbo C included a built-in 
debugger, its ease of use and wealth of 
user control would have been made it 
my hands-down winner, even without 
mouse support. If Quick C had included 
more control of directories and com- 
piler features from within the environ- 
ment, and had Microsoft not purposely 
shackled the package, Quick C with its 
mouse interface and its fine debugger 
would have come out on top. 

I might also point out that the avail- 
ability of Microsoft C 5.0 does not 
change my opinion much. Despite 
Microsoft’s attempts, I cannot find 
much to differentiate C 5.0 from Quick 
C—other than two extra manuals and 
the included Codeview debugger. If 
you already have Codeview, stay with 
Quick C and borrow the extra manuals 
when you need them. In addition, I 
would still put Turbo C plus any good 


source code debugger up against 
Microsoft C 5.0, despite the disparity 
in price. 

There being no overwhelming win- 
ner, I applaud both packages. While 
neither is without flaws, both compil- 
ers are excellent, first-class develop- 
ment tools at a very reasonable price. 
C programmers should be ecstatic. [] 


Stephen Randy Davis is technical 
editor for Micro/Systems, and a pro- 
grammer for a defense contractor in 
Greenville, Texas. 


Product Information 


Microsoft Corp 
16011 N.E. 36th Way 
Box 97017 

Redmond, WA 98073 
(206) 882-8080 


Borland International 
4585 Scotts Valley Dr. 
Scotts Valley, CA 95066 
(408) 438-8400 


A Reliable PC/XT Compatible 


for the 


Cornerstone of Your Products 
SLICER Announces The SLY40-XT. 


Pop-Up Productivity for Programmers. 


No matter what language you program in, XO-SHELL will help 
you hurdle the barriers to working faster and more efficientiy 
by eliminating programming hassles. Only with RAM-resident 
XO-SHELL can you: 

DO CROSS-REFERENCING without leaving your editor 

VIEW ANY FILE and TRANSFER ANY SECTION into your 

editor or to your printer 

VIEW, COPY and ERASE files directly from a SCROLLABLE 

DIRECTORY DISPLAY 

With a single key stroke RETRIEVE previous DOS commands, 

then EDIT and REEXECUTE them 

DO SOURCE-LISTING while in your application 

OBTAIN KEY-CODES without a reference and without going 

through difficult interpretation 

INSERT GRAPHICS CHARACTERS in your source code. 


XO-SHELL is for PCs, XTs, ATs, PS/2s, compatibles. 


VN. $49 


plus $5 shipping & handling 


Call today toll-free 
WYTE CORPORATION 


(800) 635-5011 


In MA: (617) 868-7704 
Cambridge. MA 02138 Visa, MasterCard 
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The SLY40-XT is a small (4-”4” by 9-/4"’) four 
layer card featuring all of a PC/XT mother 
board functions. This board is composed 
of just 17 low power CMOS ICs, and it simp- 
ly plugs into a passive back plane or 
SLICER’s TEN SLOT BUS BOARD. 


¢ NEC’s 8 MHZ V40 


¢ One Megabyte of Zero Wait State RAM 


e Ideal For Tough Industrial, OEM and 
Portable Applications 


e American Made and Fully Supported 
by Slicer 


PC and XT Are Trademarks of International Business Machines 


Slicer Computers Inc. 
+} 3450 Snelling Ave. So. 
‘alan SLICER” Minneapolis, MN 55406 
Check 612/724-2710 
Money Orde Sana > Telex 501357 
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Expand your skills 
with Turbo Tech Report 


Turbo Tech Report is a bimonthly 
newsletter/disk publication for Turbo 
Pascal programmers. If you use Turbo 
Pascal regularly and are looking for 
powerful utilities to incorporate into 
your own programs, Turbo Tech 
Report is for you. 

Each bimonthly issue delivers 
useful programming techniques and 
tools on paper and on disk — ar- 
ticles, reviews, Product-in-Action 
tidbits, and source code on disk. 

Subscribe now and receive our 
special spring discount — just 
$89.00 for a year's worth of Turbo 
Pascal tools! 


I need the following disk format (check one): 
____ PC-DOS/MS-DOS ____ Macintosh 
CP/M: ___ Apple ___ Osborne ___ Kaypro 
PAYMENT MUST ACCOMPANY ALL ORDERS 


Check enclosed, payable to Turbo Tech Report, 
for $89.00. ($129 for orders outside U.S.) 


Please charge my:__ Visa ____ Mastercard ___ American Express 
Card # Exp. date 
Name on Card | 
Signature. | 
Please mail the subscription to: | 
Name | 
Address ak Serene eee ee 
City State Zip 
| 


Please allow four to six weeks for subscription to begin. 


| A publication of M&T Publishing, Inc. 3APR 


Mail this coupon to M&T Publishing, 501 Galveston Drive, Redwood City, CA 94063 


Product Review 


The Atron MiniProbe I 


Debugger 


An inexpensive, hybrid 


debugging solution. 


by Michael Guttman and Bruce Gould 


N.. every serious program- 


mer owns some sort of debugger. Al- 
though software debuggers are not 
usually expensive, even a modestly ca- 
pable hardware debugger can cost 
$1,000. Since this may often be more 
expensive than the computer itself, one 
might think twice before buying. 

Atron now offers the MiniProbe I, a 
hybrid debugging solution that com- 
bines Atron’s sophisticated symbolic 
debugging software with enough hard- 
ware to give the feel of a “real” hard- 
ware debugger, all for $395. In addi- 
tion, the MiniProbe offers a direct 
hook into Microsoft’s Codeview, one 
of the most sophisticated and popular 
source-level debuggers around—and 
an indirect interface to Microsoft’s 
Symdeb debugger. 

We tested the MiniProbe I over a 
period of several months, using it in a 
wide variety of situations (including 
debugging a number of assembly lan- 
guage TSR programs we have under 
development). We also tested the 
MiniProbe with Codeview. 


Installation 

We installed the MiniProbe I on an IBM 
AT, although the MiniProbe also will 
work with any PC or XT. The Atron 
hardware consists of a half-size plug-in 
card and a crash recovery switch box. 
Physical installation involves inserting 
the board into any available expansion 
slot and then connecting the switch box 
via a connector at the rear of the board. 
A jumper setting on the board allows 
the user to change the MiniProbe’s I/O 
port settings if necessary to avoid con- 
flicts with other boards. 
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Although installation proceeded 
smoothly enough, we noticed that the 
six-pin switch box connector on the 
board is very flimsy and easy to con- 
nect incorrectly. Several times, nor- 
mal adjustments to the machine—tak- 
ing off the cover for servicing or 
adding a new board—unseated the 
connector. This did not happen to us 
because we were careful not to place 
any stress on the connection. 

The MiniProbe hardware also allows 
the option (for ATs only) of reconnect- 
ing the computer’s reset switch to the 
MiniProbe switch box. This allows the 
user to reboot the computer without 
having to power down when the normal 
Ctrl-Alt-Del key sequence won’t work. 
However, since the instructions were 
unclear and warned about damaging 
our computer, we decided not to install 
this option. 

Once the MiniProbe hardware is in 
place, the user can test the MiniProbe 
by running the CHECKOUT.EXE pro- 
gram provided on the software disk- 
ette. The diskette also contains the 
DEBUG.SYS device driver used to in- 
terface with Codeview and the 
WATCH.EXE program used to interface 
with Symdeb. (Use of the Codeview 
device driver naturally requires a 
DEVICE=DEBUG.SYS entry in your 
CONFIG.SYS file.) 

While installation of the MiniProbe 
on our IBM AT was successful, we 
could not install the MiniProbe on our 
Televideo AT. In short, the MiniProbe 
simply does not work with the Tele- 
video, and, according to Atron, it also 
won’t work with a number of other 
clones, including the Zenith 241 and 


248, the Sperry IT, the Compaq Por- 
table 286, the ITT Xtra, the Panasonic 
AT, or the PC’s Limited AT. Clone 
owners should check with Atron to 
find out if their machine has been 
tested before buying the MiniProbe. 


Operating the MiniProbe with 
Codeview and Symdeb 

There are three software options that 
can be used with the MiniProbe: Code- 
view, Symdeb, or Atron’s Software 
Source Probe. Hardware settings are 
the same for the three modes, so inter- 
mingling the three options on the same 
machine to solve different problems is 
quite practical. 

The MiniProbe interacts with Code- 
view via the DEBUG.SYS device driver. 
When Codeview is active, the Mini- 
Probe hardware will automatically 
take over watching one memory area 
as defined in a Codeview watchpoint or 
tracepoint setting. 

The main advantage of the Mini- 
Probe in this configuration is that it can 
perform a checking operation up to 
1,000 times faster in hardware (accord- 
ing to Atron sources) than the Code- 
view software alone. This extra speed 
is particularly useful if the variable be- 
ing checked is nested deep down and 
called by many routines. Debugging 
that could otherwise take minutes or 
hours can be reduced to seconds. 

A basic limitation of the MiniProbe I 
is that it can only watch one memory 
area at a time, making it less useful if 
you need to watch for multiple mem- 
ory areas. However, the MiniProbe 
interface will always check the last 
variable mentioned in a watchpoint 
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Quit Wasting Time! 
As a programmer, most of your time is spent writing and de- 
bugging source code, and documenting your work. A powerful, 


easy-to-use programmable text editor could be saving you 
HOURS of unnecessary effort. 


Only MULTI-EDIT has all these time-saving features: 


Fully automatic Windowing and Virtual Memory. 
Edit multiple files regardless of physical memory size. 
Easy cut-and-paste between files. 

View different parts of the same file. 


Powerful, EASY-TO-READ high-level macro language. 
Standard language syntax. 
Full access to ALL Editor functions. 
Automate repetitive tasks. 
Easy, automatic recording of keystrokes. 


Language-specific macros for ALL major languages. 
Smart indenting. 
Smart brace/parenthesis/block checking. 
Template editing. 
Supports C, Pascal, BASIC and Assembler. 
Terrific word-processing features for all your 
documentation needs. 
Intelligent word-wrap. 
Automatic pagination. 
Full print formatting with justification, bold type, 
underlining and centering. 
Even a table of contents generator. 
Compile within the editor. 
Automatically positions cursor at errors. 
Built-in MAKE capabilities. 
Run compiled program without leaving editor. 
Automatically allocates all available memory to compiler 
or program. 


Complete DOS Shell. 
Scrollable directory listing. 
Copy, Delete and Load multiple files with one command. 
Background file printing. 

Regular expression search and translate. 

Condensed Mode display, for easy viewing of your 

program structure. 

Pop-up FULL-FUNCTION Programmer's Calculator and 

ASCII chart. 


and MOST IMPORTANT, 
the BEST user-interface on the market! 


+ Extensive context-sensitive help. 

+ Choice of full menu system or logical function key layout. 
Function keys are always labeled on screen (no guessing 
required! ). 

+ Excellent online, interactive tutorial. 

Keyboard may be easily reconfigured and re-labeled. 


Users of Wordstar and Turbo Pascal’s Editor could be programming in a fraction of the time with these features. 


NO EDITOR ON THE MARKET TODAY HAS ALL THESE FEATURES, OR OFFERS YOU THIS MUCH POWER 
AT A REASONABLE PRICE, EXCEPT 


COMPLETE 
Or Get our FULLY FUNCTIONAL DEMO 


Multi-Edit $99.°=-«:; 


VERSION 2.0 


Requires IBM/PC/XT/AT/PS2 or full compatible, 256K RAM, PC/MS-DOS 
2.0 or later-Multi-Edit and American Cybernetics are trademarks of American 
Cybernetics. BRIEF is a trademark of Underware, Inc. Norton Editor is a 
trademark of Peter Norton Computing, Inc. Vedit is a registered trademark of 
CompuView Products Inc. Copyright 1987 by American Cybernetics. 


Get our FULLY FUNCTIONAL DEMO Copy for only $10! 
To Order, Call 24 hours a day: 


In Arizona: 1-602-890-1166 
Credit Card and COD orders accepted 
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American Cybernetics 


138 Madrid Plaza 
Mesa, AZ 85201 


1-800-221-9280 Ext. 951 


Eco-C88 
C Compiler with 


Cmore Debugger 


Professionals prefer the Eco-C88 C 
ric ad for ease of use and its power- 
ful debugging features. Our “pic 

flag” gives you nine levels of lint-like 
error checking and makes debugging 
easy: 


‘T’m very impressed with the com- 
piler, editor, and debugger. I’ve tried 
quite a few different compilers for the 
PC and have given up on all of the 
others in favor of yours... I’ve gotten 
to the point where I download C code 
from a DEC VAX/VMS system just to 
be able to compile it with the picky 
flag set at 9. It finds lots of things 
VMS totally ignores...” 

JS, Oak Ridge, TN 


The Eco-C88 compiler includes: 

¢ A full-featured C compiler with 4 mem- 
ory models (up to 1 meg of code and 
data) plus most ANSI enhancements. 

¢ Without a doubt, the best error check- 
ing you can get. We catch bugs the 
others miss, making you much more 


productive. 

¢ Cmore is a full-featured source code 
debugger, not some stripped-down 
version. 

¢ Robust standard library with over 230 
useful (no “fluff’) functions, many of 
which are System V and ANSI compat- 
ible. Full source is available for only 
$25.00 at time of order. 

* CED, a fast, full screen, multiple- 
window program editor with on-line 
function help. You can compile, edit, 
and link from within CED. 


¢ cc and mini-make utilities included that 


simplifies the most complex compiles. 
¢ Users manual with over 150 program 
examples (not fragments) to illustrate 
how to use the library functions. 
¢ Fast compiles producing fast code. 


Our Guarantee: Try the Eco-C88 compiler for 
$99.95, Use it for 30 days and if you are not 
completely satisfied, simply return it for a full 
refund. We are confident that once you’ve 
tried Eco-C88, you'll never use anything else. 
Call or write today! 


Orders: 1-800-952-0472 
info: 1-317-255-6476 
— Me 130. ey hei 
Indianapolis, IN 46220 


-— ECOSOFT 
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statement, allowing a clever user to 
construct his statements with the 
most accessed variable last. 

The procedure for using the Mini- 
Probe with Symdeb, although less ele- 
gant, is not difficult. It consists of run- 
ning the WATCH.EXE program from 
within Symdeb using the DOS com- 
mand line option. Depending on the 
command-line options selected, the 
user can set a watchpoint for either 
memory or I/O addresses. 


The Atron Software 

Source Probe 

Although many programmers may be 
interested only in the MiniProbe’s in- 
terface to Codeview, Atron’s product 
also comes with a complete debugger 
called the Software Source Probe that 
debugs assembly programs and pro- 
grams written for other compilers. 
Like Codeview or Symdeb, the Source 
Probe will run without the MiniProbe, 
but receives a useful assist from the 
hardware. 

The Source Probe can be run in two 
modes: as a regular program and as a 
resident program. As a regular pro- 
gram, the Probe can be used to load 
and run an application so that when the 
STOP button on the switch box is 
pressed, it will freeze the application. 
If the Probe runs as a TSR (terminate- 
and-stay-resident program), the appli- 
cation to be debugged is started in the 
usual way, from the DOS prompt. 
When the STOP button is pressed, the 
Probe springs to life and freezes the 
application. Now the user can leisurely 


L Table 1. Representative Source Probe Commands 


examine the state of the system, exe- 
cute the application one instruction at 
a time, or let it resume running in the 
normal mode. 

We found the Atron Probe run in the 
TSR mode invaluable in debugging our 
own TSR applications. In particular, we 
used the Probe’s ability to set break- 
points in our code by calling interrupt 3. 
When the Probe was running as a TSR, 
an application calling interrupt 3 causes 
the Probe to pop up and the application 
to freeze. Unfortunately, this feature is 
not explicitly mentioned in the docu- 
mentation—we discovered it intu- 
itively based on information hidden in 
an appendix of technical information. 

One of the TSRs we debugged took 
control of the keyboard and caused fre- 
quent freeze-ups of the system when 
we used the Probe. (Atron does warn 
of this possibility.) In order to avoid 
this problem, we used the remote-con- 
sole feature of the debugger. 

By connecting the COM port on our 
PC/AT via an RS-232 cable to another 
PC running a terminal emulator pro- 
vided by Atron, the debugger screen 
appears and debugger commands are 
accepted from the second PC, leaving 
the first PC free to handle only the I/O 
of the user’s application. This arrange- 
ment effectively allowed us to type in 
debugger commands on the second 
keyboard without interfering with the 
TSR program. 

Unfortunately, the pin settings re- 
quired on the connecting cable are 
nonstandard, and not properly docu- 
mented. Only after contacting Atron 


BREAKPOINT—Defines a breakpoint at a given address or symbol. The 
program will run until a breakpoint is encountered. 


BYTE—Displays the contents of memory at a certain address. For example, 


by 0010:0010 1 10 


will display 16 bytes of memory, in hex, starting at location 
110h. (Addresses are expressed using the standard 


segment:offset method.) 


POINTER—Displays the contents of memory as if the memory contains 
addresses in the segment:offset notation. (We found this useful in 


ptr 0000:0000 


examining the values of interrupt vectors in low memory.) For 
example, the command 


on our machine yielded the following line: 


019a:4ee8 O0f7a:0298 Of7a:01bb 0f7a:0260 


from which we infer that interrupt zero points to 019a:4ee8. 


R—Displays the values of all registers and flags. 
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for additional information and making a 
special cable did we get the remote- 
terminal feature to work. 

Some debuggers, like Codeview, 
have screen windows that allow for 
easy monitoring of system informa- 
tion. Unfortunately, the Atron Source 
Probe has no such facility. For exam- 
ple, the R command must be typed 
each time the user needs to view the 
values of all registers and flags. As the 
debugger is used, the information on 
the screen scrolls up and disappears. 
The R command must be repeatedly 
typed to monitor the registers. 

However, the Source Probe does 
have a macro language that can store a 
number of debugging commands as a 
unit and execute them by invoking the 
macro name. This language has simple 
procedural capabilities, e.g., there are 
IF and LOOP commands that test con- 
ditions and cause the conditional exe- 
cution of macro commands. 

The macro language somewhat miti- 
gates the disadvantage of not having a 
window. Continually monitoring regis- 
ters provides the ability to execute 
automatically via a macro after each 
GO or STEP command (see Table 1). 
This frees the user from constantly 
having to type R, for example, in order 
to see the registers after each instruc- 
tion has been executed. However, it 
does not create a very pretty display. 

The Source Probe also constantly 
displays a ‘‘help” area at the bottom of 
the screen. As soon as a typed com- 
mand is recognized by the debugger, 
the syntax and the options of the com- 


mand appear on the bottom of the 
screen. 


Documentation and Support 
The least satisfying component of the 
MiniProbe I and the Source Probe is 
the documentation. In addition to the 
examples cited above, we found the 
documentation lacks clarity and accu- 
racy. As a result, we had to experi- 
ment with the program, scrutinize the 
manuals, or call technical support to 
uncover many of the most useful fea- 
tures of the software. 

Fortunately, the quality of the tech- 
nical help we got over the phone from 
Atron was very good. The staff took 
the time to walk us through problems 
and explain obscure points. Despite 
some very annoying documentation 
problems, we think the Atron Mini- 
Probe I is a solid product and a good 
value. im 


The authors are consultants with 
Morrisey Associates, a software devel- 
opment and consulting firm based in 
Skokie, Illinois. 


Product Information 
MiniProbe I $395 


Atron Division 
Northwest Instument 
Systems Inc. 

20665 Fourth St. 
Saratoga, CA 95070 
(408) 741-5900 


UNASSEMBLE—Displays the assembly code at a specified address. For 


example, 


u 019a:4ee8 


will display the code that interrupt zero points to. 


STEP—Steps through code one instruction at a time. After this instruction is 
entered, pressing the Enter key will cause one instruction to be 


executed, until a non-Enter key is pressed. Variations of this 
command will allow the programmer to step over interrupts or 
called procedures. In its simplest form, the step command will 
trace through ail code, including the operating system interrupt 


code. 


GO—FExecutes the program until a certain address or breakpoint is reached. 


PORT—Displays or modifies the contents of an I/O port. 


MOVE—Moves a block of memory, specified by a starting and ending ad- 


dress, to a new location. 


LIST—Copies the output of Probe commands to another device, giving a 
history of a debugging session. 
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goodbye 
dBase! 


dBASE Programmers 


You need it! 
CR You can handle it! 
(7 2dB2c is here now! 


dB2c Offers: 

* Version 2.0 complete with 
Translator and File 
Handlers. 

* Extensive implementation 
of dBASE III+ with over 200 
functions and commands in 
C source code. 

* Contains our own File 
Handlers plus interfaces for 
Lattice's dBC and Faircom's 
c-tree. 

-« Supports screen I/O with 
ANSI.SYS or fast assembler 
routines. 

* Support for Microsoft, 
Lattice and Turbo C 
compilers. 

* Tutor features of translation 
combined with familiar 
syntax of the library eases 
the transition to 'C’. 

* One version supports MS- 
DOS, Xenix, Unix, OS-9 
and Concurrent DOS. 


are you 
ready? 


ells 


Toolkit $299 


Call or Write: 
SOFTWARE 
CONNECTION, INC. 
POB 712, Ely, MN 55731 
(218) 365-5097 
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Listing continued from page 27 


fendif 


DBUGFLG6 = true; 
} 
} else { 
break; 
} 
C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (Cc == '1') { 
DBUGFLG7 = true; 
} 


} else { 
break; 
} 
C = fgetc(FLAGHNDL) ; 
if (C != EOF) { 
if (C == ‘1') { 
DBUGFLG8 = true; 
} 
} else { 
break; 
} 


break; 


/* Set debug level flags from environment */ 


#ifdef ENVFLAG 


FLAGPTR = envfind("DBUGFLGO") ; 
if (FLAGPTR) { 


FLAGPTR = envfind("DBUGFLG8") ; 


if (FLAGPTR) { 
st repy (FLAGLIT, FLAGPTR) ; 


if (strcmp (upper(FLAGLIT),"TRUE") == 0) { 


DBUGFLG8 = true; 


} 
free (FLAGPTR) ; 


fendif 


/* Set file to nul unless at least one debug flag > 0 


is true */ 


if ( ! (DBUGFLG1 || DBUGFLG2 || DBUGFLG3 || DBUGFLG4 || 
DBUGFLG5 || DBUGFLG6 || DBUGFLG7 || DBUGFLG8)) { 


st rcpy (DBUGNAME, "nul") ; 
) 
if (DBUGFLGO) { 

DBUGHNDL = stderr; 
} else { 


DBUGHNDL = fopen(DBUGNAME, "w") ; 


if (DBUGHNDL == 0) { 


fprintf(stderr,"\nDBUGOPEN: * Abort at ‘fopen’ - "); 


fprintf(stderr,"Error Return is %d *\n", 


ferror (DBUGHNDL) ) ; 


exit(1); 
} 
} 
DBUGTIME () ; 
fprint£(DBUGHNDL, 


"DBUGOPEN: Debug Started with SCCSID='%s’\n",SCCSID); 


strepy (FLAGLIT, FLAGPTR) ; 


if (strcemp(upper(FLAGLIT), "TRUE") == 0) { 


DBUGFLGO = true; 
} 
free (FLAGPTR) ; 
} 
FLAGPTR = envfind("DBUGFLG1") ; 
if (FLAGPTR) { 
st repy (FLAGLIT, FLAGPTR) ; 


DBUGINT (FUNC, "DBUGFLGO", DBUGFLGO) ; 
DBUGINT (FUNC, "DBUGFLG1", DBUGFLG1) : 
DBUGINT (FUNC, "DBUGFLG2", DBUGFLG2) ; 
DBUGINT (FUNC, "DBUGFLG3", DBUGFLG3) ; 
DBUGINT (FUNC, "DBUGFLG4", DBUGFLG4) ; 
DBUGINT (FUNC, "DBUGFLG5", DBUGFLGS) ; 
DBUGINT (FUNC, "DBUGFLG6", DBUGFLG6) ; 
DBUGINT (FUNC, "DBUGFLG7", DBUGFLG7) ; 
DBUGINT (FUNC, "DBUGFLG8" , DBUGFLGS8) ; 


if (stremp(upper(FLAGLIT) , "TRUE") 
DBUGFLG1 = true; 
} 
free (FLAGPTR) ; 
} 
FLAGPTR = envfind("DBUGFLG2") ; 
if (FLAGPTR) { 
strepy (FLAGLIT, FLAGPTR) ; 
if (strcmp (upper (FLAGLIT) , "TRUE") 
DBUGFLG2 = true; 
} 
free (FLAGPTR) ; 
} 
FLAGPTR = envfind("DBUGFLG3") ; 
if (FLAGPTR) { 
st rcpy (FLAGLIT, FLAGPTR} ; 
if (strcmp (upper (FLAGLIT) , "TRUE") 
DBUGFLG3 = true; 
} 


free(FLAGPTR) ; 
} 
PLAGPTR = envfind("DBUGFLG4") ; 
if (FLAGPTR) { 
st rcpy (FLAGLIT, FLAGPTR) ; 
if (strcmp (upper (FLAGLIT) , "TRUE") 
DBUGFLG4 = true; 
} 
free(FLAGPTR) ; 
} 
FLAGPTR = envfind("DBUGFLG5") ; 
if (FLAGPTR) { 
strcpy (FLAGLIT, FLAGPTR) ; 
if (strcmp (upper (FLAGLIT) , "TRUE") 
DBUGFLGS = true; 
} 
free (FLAGPTR) ; 
} 
FLAGPTR = envfind("DBUGFLG6") ; 
if (PLAGPTR) { 
strcpy (FLAGLIT, FLAGPTR) ; 
if (strcmp (upper (FLAGLIT) , "TRUE") 
DBUGFLG6 = true; 
} 
free (FLAGPTR) ; 
} 
FLAGPTR = envfind("DBUGFLG7") ; 
if (FLAGPTR) { 
st repy (FLAGLIT, FLAGPTR) ; 
if (strcmp (upper (FLAGLIT) , "TRUE") 


fprint£(DBUGHNDL, "\n") ; 
fflush (DBUGHNDL) ; 

} else { 
DBUGTIME() ; 


fprintf (DBUGHNDL, "DBUGOPEN: Debug File Already Open\n"); 


£f1lush (DBUGHNDL) ; 
} 
} /* end DBUGOPEN */ 


public void DBUGPTR(P_FUNC,P_NAME, P_VALUE) 


string P_FUNC(]; f® 
string P_NAME[]; /* 
char *P_VALUE; i 


/* Print pointer name P_NAME value P_VALUE in 


function P_FUNC. */ 


static string FUNC[] = "DBUGPTR"; 


in */ 
in */ 
in */ 


unsigned int SEGMENT; 
unsigned int OFFSET; 
unsigned long int ABSOLUTE; 


extern unsigned long int ptrtoabs(); 


/* begin */ 
if (! DBUGOPFL) { 
DBUGOPEN () ; 
} 
DBUGTIME () ; 


fprint£(DBUGHNDL,"$-8s: %-16s=",P_FUNC,P_NAME); 


#ifdef C86 BIG 


SEGMENT = (unsigned int) (((unsigned long int)P VALUE) >> 16); 


OFFSET = (unsigned int)P_VALUE; 
ABSOLUTE = ptrtoabs(P_VALUE) ; 


fprintf£(DBUGHNDL," Ptr Segm-%04x Ofst=%04x 


SEGMENT, OF FSET) ; 


fprintf (DBUGHNDL, "Abs=%051x\n" , ABSOLUTE) ; 


#else 
OFFSET = (unsigned int)P_VALUE; 


fprintf(DBUGHNDL," Ptr Ofst=%04x\n", OFFSET) ; 


#endif 
fflush(DBUGHNDL) ; 
/* end DBUGPTR */ 


public void DBUGSTAK(P_FUNC, P_NUM) 


string P_FUNC[]; "has 
int P_NUM; bei 


in */ 


DBUGFLG7 = true; /* Print stack presented to function P_FUNC: base pointer 
} (actually generated by P_FUNC), return address (big 
free (FLAGPTR) ; Memory model), P_NUM words of parameter entries. */ 
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static string FUNC[] = "DBUGSTAK"; 

unsigned short BP; /* base pointer */ 
unsigned short We; /* work pointer */ 
unsigned short Ss; /* stack segment */ 
unsigned short VAL; /* stack entry value */ 
striag CSTR(4+1]; /* stack entry value */ 
struct segregs SEGS; /* segment registers */ 
unsigned int Ii 


/* begin */ 
if (! DBUGOPFL) 
DBUGOPEN (} ; 
i 
BP = BASEPTR(); 
segread(&SEGS) ; 
SS = SEGS.sss; 
BP = peek(BP,SS); /* chain to stack presented to 
function that called DBUGSTAK */ 
DBUGTIME() ; 
fprintf(DBUGHNDL, "%-8s: %-l6s Address Hex Int Char\n\n", 
P_FUNC, "Stack"); 
for (I= 0; I < P_NUM+ 3; I++) { 
We = BP + (2 * I); 
VAL = peek (WP, SS) ; 
DBUGXLCH (CSTR, VAL) ; 
fprint£ (DBUGHNDL, "%37s%04x:%04x %04x% %6d %s\n", 
* ",SS,WP, VAL, VAL, CSTR) ; 
} 
fprint£(DBUGHNDL, "\n") ; 
fflush (DBUGHNDL) ; 
/* end DBUGSTAK */ 


public void DBUGSTR (P_FUNC,P_NAME, P_ VALUE) 
string P_FUNC[]; /* in */ 
string P_NAME[]; /* in */ 
string P_VALUE[]; /* in */ 


/* Print string name P_NAME value P_VALUE in 
function P_FUNC. */ 


static string FUNC[] = "DBUGSTR"; 
int 3 
string TEMP (256 + 1]; 


/* begin */ 
if (! DBUGOPFL) { 
DBUGOPEN () ; 
} 
DBUGTIME (} ; 
fprint£(DBUGHNDL, "%-8s: %-16s=",P FUNC,P NAME) ; 
DBUGXLST (TEMP, P_VALUE) ; 
fprint £(DBUGHNDL, "’ ts’ \n", TEMP) ; 
ff1lush (DBUGHNDL) ; 
}  /* end DBUGSTR */ 


Listing 3. BASEPTR.ASM; Get base pointer 


C language calling sequence for this function is: 
unsigned int BP; 


BP = BASEPTR (); 


include model.h 
include prologue.h 
public BASEPTR 


IF @BIGMODEL 
BASEPTR proc far 

ELSE 
BASEPTR proc near 

ENDIF 


push bp # save registers (standard entry) 
mov bp, sp 
pop ax ; base pointer to ax as return value 
push ax 
mov sp,bp ; restore registers (standard return) 
pop bp 
ret ; return 

SCCSID db '@(#)baseptr.asm 5.3.0 

BASEPTR endp 
include epilogue.h 7C86 
end 


Listing 4. DEMODBUG.C; Demonstrate debug functions 
static char SCCSID[] = "@(#!demodbug.c 5.2.4"; 


SPECIAL DEFINES */ 
#define void 


/* INCLUDE */ 


#define EXTERNAL extern ah vtati ° 
Listing continues 
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MICROSOFT, TURBO AND MIX POWER C PROGRAMMERS. .. 
C WINDOWS TOOLKIT PUTS YOU IN CHARGE OF VIDEO! 


C Windows Toolkit is the only C programmer’s windowing package 
that comes with a complete tutorial on monochrome, Hercules, 
CGA and EGA video. We don’t just provide the functions, we also 
explain how to use them reliably. 

And C Windows Toolkit comes with full, commented source code 
(would you trust a package that didn’t?). 


WINDOWING EGA/VGA SUPPORT 
FUNCTIONS © Use all 64 EGA colors 


i ¢ Use EGA 43-line mode 
* Greate pop-up windows * Use 2 fonts simultaneously 
© Create pull-down menus © Design custom fonts 
Rf Marsdaatemgealtalr a © Smooth scroll the screen 
© Create context-sensitive help screens * Smooth pan the screen 
© Store windows for recall later 


© Free memory used by windows 
© Use 8 different types of exploding windows PAST SCREEN LO 
SYSTEM SUPPORT © Write formatted output (like printf( ) ) 


© Get snow-free output on the CGA 
* Scroll the screen 
¢ Read characters off the screen 


© Detect how many video adaptors are present 
© Detect the types of video adaptor installed 
© Switch between adaptors 


* Detect ANSI.SYS 
© Control the size and position of the cursor HERCULES SUPPORT 
Detect the Enhanced Keyboard © Detect the presence of a Hercules Card 
* Disable the video signal * Detect Ramfont support 
© Delay program execution to microsecond * Load a Ramfont 

resolution © Switch between modes 


Over 80 functions that enhance your productivity. 
Full source code included — No run-time royalties 
Includes 200 page manual — 30-Day Money-Back Guarantee 


Requires: IBM PC, XT, AT, PS/2 or compatible that will run 
Microsoft C and/or Quick C 
Supports Microsoft C 4.0/5.0/Quick C, Borland Turbo C 1.0/1.5, 


Mix Power C 
From: nen Carta Software gee 
P.O. Box 475594 Ad 
Garland, TX 75047-5594 se Only $99.95 
(214) 226-6909 mG4, (Texas residents add 8% sales tax) 


IS NOTHING 
SACRED? 


Now the FULL source code for TURBO Pascal is avail- 
able for the IBM-PC! WHAT, you are still trying to debug 
without source code? But why? Source Code Generators 
(SCG’s) provide completely commented and labeled 
ASCII source files which can be edited and assembled 
and UNDERSTOOD! 


SCG's are available for the following prod- “The darndest thing | 
ucts: ever did see...” 
_ TURBO Pascal ver 3 (IBM-PC)* . .$67.50 Pournelle, BYTE 


— TURBO Pascal ver 3 (Z-80)*. . . .$45.00 “| have seen the original 


source and yours is 
much better!” 
Anonymous, SOG VI 


The following are general purpose disassem- 

blers: 

— Masterful Disassembler (Z-80) . . .$45.00 

_ Masterful Disassembler (IBM-PC) .$47.50 

—_ UNREL (relocatable files) (8080) .$45.00 t 


*A fast assembler is included free! 


“The Code Busters!" 


VISA/MC/check Shipping/Handling $1.50 
card # Tax $_ 
expires / Total $ 


All products are fully guaranteed. Disk format, 
yd fz] 5" im type 


C.C. Software, 1907 Alvarado Ave., Walnut 
Creek, CA 94596, (415) 939-8153 


CP/M and TURBO Pascal are trademarks of Digital Research & Borland Int. 
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#include <stdio.h> static char FUNC[] = "main"; 
tifdef DEBUG_1 static int 


#include <debug.h> static int 
int 
EXTERNAL extern int SUMSQ(); 


int SQUARE (P_G) /* begin */ 
int PG; #ifdef DEBUG_1 
- DBUGOPEN () : 
/* Return square. */ if (DBUGFLG1) { 
DBUGBEGN (FUNC, SCCSID) ; 
static char FUNC[] = "SQUARE"; DBUGSTR(FUNC, "Msg", "Compute Sum of Two Squares"); 
int RIN; DBUGINT (FUNC, "A", A); 
DBUGINT (FUNC, "B", B); 
/* begin */ DBUGPTR (FUNC, "C", &C) ; 
tifdef DEBUG 1 } 
if (DBUGFLG3) { fendif 
DBUGBEGN (FUNC, SCCSID) ; 
DBUGINT (FUNC, "P_G",P G) : SUMSQ(&C,A,B); 
} printf ("\nThe Value of td**2 + %&d**2 Is %d\n",A,B,C); 
#endif 
#ifdef DEBUG_1 
RIN = PG * PG; if (DBUGFLG1) { 
DBUGINT (FUNC, "C",C); 
#ifdef DEBUG 1 DBUGPTR (FUNC, "C", &C) ; 
if (DBUGFLG3) { } 
DBUGINT (FUNC, "RIN", RIN); #endif 
DBUGEND (FUNC) ; 
} #ifdef DEBUG_1 
fendif if (DBUGFLG1) { 


DBUGSTR(FUNC, "Msg","Pass Parameters for Stack Display"); 
return (RTN); } 


} /* SQUARE */ #endif 


SUMSQ(P_F,P_D,P_E) PASSPARM(‘A',’B',‘C’,‘D','E'); 
int *P_F; /* out */ 
int P_D; /* in */ #ifdef DEBUG _1 
int PE; /e in */ if (DBUGFLG1) { 
DBUGEND (FUNC) ; 

/* Compute sum of squares. */ } 

tendif 
static char FUNC[] = "SUMSQ"; 
extern int SQUARE(); } /* main */ 


| ase gece a Listing 5. DEBUG.LST; Debug output file 


if (DBUGFLG2) { 255: : M 
DBUGBEGN (FUNC, SCCSID) ; 00:55:42 DBUGOPEN: Debug Started with SCCSID='@(#)debug.c 5.3.8 


00:55:42 DBUGOPEN: DBUGFLGO 
DBUGINT(FUNC,"P_D",P_D); ‘ : : 
rom abel Pg pe 00.85142 DBIGOPEA: DBUGFLCZ 
ial 00:55:42 DBUGOPEN: DBUGELG3 
Feasts 00:55:42 DBUGOPEN: DBUGFLG4 
00:55:42 DBUGOPEN: DBUGFLGS 
ee ee 00155:42 DRUGOPEN; DBUGELGT 
00:55:42 DBUGOPEN: DBUGFLG8 
i 1 A 
? “ie ponte er { 00:55:42 main : Begin with SCCSID=’@(#)demodbug.c 5.3.4’ 
DBUGINT (FUNC, "P_F",*P_F); sara er ; “ : — Sum of Two Squares 
DBUGPTR(FUNC, "P_F",P_F); 355242 ma. : 


: 00:55:43 main :B = 3 
} i a 00:55:43 main =: C = Ptr Segm=6771 Ofst-FF48 Abs=77658 


fendif 00:55:43 SUMSQ : Begin with SCCSID=’@(#)demodbug.c 5.3.4’ 
} /* suMsQ */ 00:55:43 SUMSQ. : PD = 2 
00:55:43 SUMSQ. : PE = 3 
00:55:43 SUMSQ. : PE =0000000000000011b 
SS ’ ’ ’ =- 
se aes et PPD i 00:55:43 SQUARE : Begin with SCCSID=’@(#)demodbug.c 5.3.4’ 
int PB; yx 00:55:43 SQUARE : PG - 2 
int Puc; yx 00:55:43 SQUARE : RIN ~ 4 
int PD: /* 00:55:43 : End 
int PE: [* i 00:55:43 : Begin with SCCSID=’@(#)demodbug.c 5.3.4’ 
=" 00:55:43 : BG - 3 
00:55:43 : RIN = 9 
*? = Hy 
/* Pass Parameters. */ peed a 
uit We 00:55:43 : PF = 13 
BARRE TOO RARER: 00:55:43 PF = Ptr Segm=6771 Ofst-FF48 Abs=77658 
/* begin */ 00:55:43 : End 
baronet oaea * any 6171 Ofst=FF48 Abs=77658 
if (DBUGFLG2) { 00:55:44 eG = Ptr Segm= ‘s 3 
DBUGBEGN (FUNC, SCCSID) ; 00:55:44 : Msg ='Pass Parameters for Stack Display’ 
DBUGSTAK (FUNG, 7) ° . 00:55:44 PASSPARM: ‘Begin with SCCSID=’@(#)demodbug.c 5.3.4’ 
} oa 00:55:44 PASSPARM: Stack Address Hex Int 
es 6771:FF38 FF4A ~-182 
printf("\nts: Parameters '%c’ ‘tc’ ‘tc’ ‘%c’ ‘%c'", 6771;:FF3A 02B0 688 


7711: 23216 
FUNC, P_A,?_B,P_C,P_D,P_E); ernLiiae ooal 65 


#ifdef DEBUG_1 6771:FF40 0042 66 
F 6771:FF42 0043 67 
if (DBUGFLG2) { 

DBUGEND (FUNC) ; 6771:FF44 0044 68 
} : : 6771:FF46 0045 69 

fendif 6771:FF48 000D 13 

SegEUER? 6771:FE4A FEF2 -14 
* ARM * 00:55:44 PASSPARM: End 

lect 00:55:44 main : End 


End Listing 5 
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FOR ORDERING AND 
INFORMATION 

OND) 

SEE INSERT 

CARD. 


IT’S LIKE HAVING A 
DESKTOP FULL OF PCs 


and future. Without modification. VM/386 is compati- 
ble with 80386-based PCs—either native or Intel® 
Inboard 386.™ VM/386 will support the monitors, hard 
disks, printers, mice, modems—even the network— 
you're currently using—or plan to use. 


We know why you have it. Power. And now you can 
multiply that 386 power. Through true multitasking. 
With VM/386"" 


VM/386 is the 80386 control program that brings you 
true DOS multitasking. VM/386 uses the virtual 8086 
mode, built into the 80386 processor, to create individ- 
ual virtual machines. You can load a different applica- , 
tion in each virtual machine. It’s like having a desktop 
full of PCs. 


You have complete control over the virtual machines. 
You can tailor each virtual machine to fit your needs— 
and priorities. Each virtual machine has its own DOS, 
CONFIG.SYS, AUTOEXEC. BAT, and memory-resident 
programs along with its application. And each virtual 
machine is isolated from the others. A malfunction in 
one program doesn’t destroy the others. 


VM/386 
The Professional 
MultiTasker.™ 


VM/386 Software 


DOS 3,1 

AutoCAD 

There is virtually no limit to the number, or kind, of 
applications that can run simultaneously. For example, 
you can recalculate a 1-2-3® spreadsheet, sort a dBASE 
III® file, and receive your E-mail—all at the same time. 
You can even run more than one AutoCAD™ program 


simultaneously. And EGA applications run in the back- 
ground as well as in the foreground—perfectly. 


DOS 3.0 DOS 3.2 


dBase LH Lotus 1-2-3° 


VM/386 protects your investment in software—and 
hardware. VM/386 will run all DOS software. Existing 


With VM/386 you use familiar commands. You don’t 
have to buy new software or upgrades to get true multi- 
tasking. No PIF files. No special loaders. VM/386 works 
the way you do. Only lots faster. 


VM/386 is easy to install. Easy to learn. And easy to use. 


Dramatically increase your productivity. Start using all 
the power built into your 80386. Phone or write today. 


IGC 


4800 Great America Parkway 
Santa Clara, California 95054 


(408) 986-8373 


System Requirements 


80386-based computer such as COMPAQ® 


DESKPRO® 386® or 80286 computer with 
Intel® Inboard™ 386 


One 1.2 Mb (5'4") disk drive 
or, one 312" microfloppy 


One hard disk drive 
DOS 3.0 or later 
2 Mb memory recommended 


Not copy protected 


Package includes both 54” and 32" media. 


C 


VM/386 is a trademark of IGC. 

AutoCAD is a trademark of Autodesk Inc. 
COMPAQ and COMPAQ DESKPRO 386 are 
registered trademarks of Compaq Computer 
Corporation. 

dBASE Ill is a registered trademark of 
Ashton-Tate Corporation. 

Intel is a registered trademark of 

Intel Corporation. 

Inboard is a trademark of Intel Corporation. 
1-2-3isa registered trademark of Lotus 
Development Corporation. 


Product Review 


The Periscope Debugégers 


A hardware/software debugging family 
that makes life easier for C programmers. 


T. Periscope line of debuggers 


includes the Models IJ, II, II-X, and III. 
The Model I consists of a plug-in card 
with 56K of protected memory, a 
breakout switch and software. The 
Model II consists of a breakout switch 
and software. The Model II-X has only 
software. The Model III has a 64K- 
protected memory card, a breakout 
switch, and the ability to trace pro- 
gram execution in real time. 


Installation 

Installing the Model I is relatively easy 
and requires inserting a plug-in card 
and attaching the breakout switch to 
the card. 

The Periscope Model JI-X requires 
only the installation of the software. 
The Model II adds the installation of 
the breakout switch and requires you 
to insert a pin into a bus slot along with 
an existing plug-in card. This is not dif- 
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by Joseph A. Sabin, Jr. 


ficult to do on a standard PC/AT or PC/ 
XT system or compatible; however, to 
accomplish this feat on a Compaq por- 
table, you need to be a contortionist. 

In addition to the installation of the 
plug-in card and breakout switch, the 
Model III requires that you remove 
the 8087 or 80287 coprocessor, if one 
is installed, and fit a socket with a rib- 
bon cable into the now empty socket 
and place the coprocessor into the 
taller socket. Then the ribbon cable is 
connected to the plug-in card. 

Once the Periscope debugger soft- 
ware is installed and your AUTOEXEC- 
.BAT file is modified (advisable but not 
required), you must sit down and read 
the rather complex manual. 


Using The Debugger 

If you are writing an operating system 
add-in, a pop-up, or a memory-resident 
program, the Model I or III with pro- 


tected memory is the preferred -tool. 
Their protected memory is needed be- 
cause, if you are not careful, these 
types of programs can crash into disk 
reads or writes, memory allocation 
calls, or other operations. The ability 
to call the debugger when the memory 
in your system has been totally scram- 
bled is, without question, a very valu- 
able debugging feature. 

Under ordinary conditions, straight- 
forward programming (even a C pro- 
gram with heavy use of pointers) will 
not crash the memory area holding the 
resident Periscope debugger software, 
which allows the programmer to use a 
software-only debugger like the Model 
II-X. It gives the programmer debug- 
ging capability similar to other full-fea- 
tured symbolic debuggers, such as 
Microsoft’s Codeview. However, if the 
software you are developing crashes 
the system and Ctrl-Alt-Del will not 
work, you need a hard- 
ware breakout switch. If 
you fit this class of pro- 
grammer, then I recom- 
mend you avoid the II-X 
software-only model. 
Most programmers will 
find the Model II almost 
as good as the protected 
memory models, and 
more cost effective. 

The Models II and III 
memory boards provide a 
safer place to stick 
debugger software and al- 
low you to have 56K-64K 
more memory available 
for your own code. In my 
system, this is important 
because otherwise I can’t 
have all my resident soft- 
ware in memory at one 
time. Without the pro- 
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tected memory, the Periscope soft- 
ware competes for the same memory 
and it does not all fit. Periscope is not 
something you load as you need it—if 
it’s not there initially it’s useless. 

The Periscope debugger can show 
source code as you single-step through 
execution, demonstrate selected vari- 
ables, and show you what is in the 
memory locations that they occupy. If 
they are pointers, you can see the value 
at the location to which they point. For 
example, if your pointer is pointing at 
one of DOS’s low-memory locations to 
show you what’s there, it should (gen- 
erally speaking) not be used for storage 
since it will probably trash DOS. I was 
amazed that a pointer in one of my pro- 
grams pointed to the wrong place and 
still worked—it was a bomb waiting to 
happen, I found it with Periscope! 

Periscope’s debugging software is 
clear, concise, and seemingly bomb 
proof. In testing for this review, I for- 
matted disks, used WordStar, com- 
piled a Turbo Pascal program to disk, 
loaded programs, saved programs, and 
made life as difficult as possible for the 
Periscope debugging software. Press- 
ing the Periscope breakout button 
never crashed the system and I was 
always able to go back to what I was 
doing as if nothing happened. Now that 
is impressive! 

Having the breakout switch is worth 
the price, if only to prevent having to 
turn the computer off and on when a 
runaway pointer trashes everything in 
memory, leaving you with only the 
ROM BIOS and a blinking cursor. Once 
my software did cause a crash from 
which the Periscope Model II could not 
reboot the computer forced me to turn 
the computer off and on to regain con- 
trol. The Models I and III, however, 
never allowed the system to go into 
hyperspace. Their protected memo- 
ries always allow the debugger to re- 
tain its composure and help me when- 
ever I ask for it. A good friend indeed. 

As with all software, I only use some 
of its power, but I can say with confi- 
dence that it works for almost any de- 
bugging task, if you choose the correct 
version for your work. 

Usually, I comment on how helpful 
the technical support for the product 
is, but this time I did not find it neces- 
sary to call for tech support. Okay, so I 
feel guilty for not calling just to find 
out, but I don’t think most program- 
mers will need to call either. 

The manual covers everything you 
need to know (not always clearly, but 
it’s there). It consists of 11 chapters, an 
appendix, and an index. The index is 
clear and covers everything that I could 
think to look for. However, additional 
examples would help in teaching uses 
for this sophisticated programming 
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tool. If you program in Assembler or C, 
there is sufficient information to get 
you started and you will learn as you go, 
using the manual mostly as a reference. 
The disk contains the source code for 
the programming samples in the man- 
ual (yes, they are the same) and this 
provides powerful tutorial for the ex- 
perienced programmer. 


Summing Up 

If you program in C or assembler un- 
der MS-DOS, then the Periscope family 
of debuggers will make your life easier. 
Compared to other debuggers, they 
are more useful in discovering real- 


I can say with 
confidence that 
it works for 
almost any 
debugging task, 
if you choose 
the correct 
version. 


time errors. I have not used other 
hardware-based debuggers, but com- 
pared to what I am used to doing to 
find a bug, this is worlds apart. Based 
on cost alone, the Periscope line has a 
very good price/performance ratio. I 
don’t imagine that another debugger 
approach could offer much more. [] 


Joseph A. Sabin, Jr., 1s Director of 
Systems Development for New Hope 
Communications, Inc. a national 
magazine publisher. He works pri- 
marily with accounting and fulfill- 
ment software programmed in C un- 
der PC-MOS and dBASE IlI+ under 
MS-DOS. 


Product Information 


Periscope I $345.00 
Periscope II $175.00 
Periscope II-X $145.00 
Periscope III $995.00 (8 MHz) 
$1,095.00 (10 MHz) 


The Periscope Company, Inc. 
1197 Peachtree St., Plaza Level 
Atlanta, GA 30361 

(404) 875-8080 


“Dear 
Genifer.? 


: “dBASE has me 
stuck at the dot prompt 
and I’m coming unglued! 


Can you save me? 
Help! I've been using dBASE for 
months at the dot prompt, but now 
I've got to write a stand-alone, end-user 
application. When | try to program, | 
get “Mismatched DO WHILE and 
ENDDO” and “Improper data type in 
subsubtotal expression.” | just can't 
take it any more! Help me Genifer or | 
swear, I'll jump off the manual!” 

- On The Edge 


« Dear On The Edge: 


Take a deep breath and listen. All you 
need is Genifer - the application 
generator that creates custom-made 
applications in minutes. That means 
you don’t have to know the details of 
dBASE programming or waste count- 
less hours cranking out code! You 
see, Genifer quickly delivers clean, 
self-documented code that makes life 
worth living! No wonder Infoworld 
said, ‘‘Genifer creates programs that 
are more clearly written than most of 
the code we've seen produced by 
human dBASEIII programmers.” If 
you're still in distress, go see your 
dealer right now. As dBASE users 
around the world know, Genifer cares! 


To find out more about how Genifer 
can change your life, visit your 

dealer or call toll-free: 1-800-631-2229 
for a FREE brochure. 

In CA: 1-800-541-3366 


Genifer. 


For dBASE Ill applications without tears. 


© > CONVe 0.0 
1029 Solano Avenue, Berkeley, CA 94706 
(415) 527-1157 Telex: 176609 
Trademark /Owner: Genifer/Bytel. dBase Ill /Ashton-Tate. 


©Copyright 1987 Bytel Corporation. 
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DATABASE QUERIES 


by P. L. Olympia, Ph.D. 


dBASE Index Files 


nyone who has ever used 
A dBASE knows that the three 

primary commands used to lo- 
cate database records are FIND, SEEK, 
and LOCATE. The first two find 
records in just a few seconds, regard- 
less of database size, while the third 
takes almost forever if the file is large 
enough. The difference in speed is due 
to record indexing. LOCATE reads each 
database file record sequentially until a 
match is found, while SEEK and FIND 
use a previously created index file to 
point to the desired record. Clearly, 
you should use index files whenever 
possible, but it is easy to get carried 
away and forget that they can be a hin- 
drance in certain situations. For exam- 
ple, if you have to use the LOCATE 
command (there are occasions when 
you don’t have a choice) you are better 
off without any active index files. 


Better Use of Index Files 
A common mistake that beginners 
make is to have too many open index 
files, especially during repetitive ap- 
pend and edit operations, because the 
application tends to get bogged down 
as each open index file is updated. Al- 
though dBASE allows up to seven index 
files to be open per work area, it is 
difficult to imagine a situation where 
that many index files are needed for 
one database, or where that many in- 
dex files must be active at one time. 
Unless you run on a network, you 
might consider the advantage in speed 
gained by batch appending/editing 
without an active index file, then in- 
dexing when you are done. The 
method you should use depends on 
how many records are being changed 
at one time, and how many index files 
need to be updated. When running on a 
network, indexing requires either a file 
lock or exclusive use of a file and 
should be avoided whenever possible. 
Another common mistake made by 
dBASE users is to devise index expres- 
sions that are unnecessarily lengthy or 
complicated. I have seen many name/ 
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address dBASE applications index a da- 
tabase using the key expression 
LASTNAME+FIRSTNAME. That not 
only wastes a lot of disk space, but 
does not optimize record searches. 
Since it is difficult to get a consensus 
on how long a name field should be, 
many programmers play it safe by as- 
signing a field width of 20-25 charac- 
ters to LASTNAME and FIRSTNAME. 
In practice, very few names require so 
many reserved characters, so you end 
up with wasted space and an index file 
that is less than optimal. 

A better expression would be some- 
thing like TRIM(LASTNAME) + TRIM- 
(FIRSTNAME). Still, do you really need 
the whole name? I prefer to use a dif- 
ferent expression such as SUBS(LAST- 
NAME, 1,8) + SUBS(FIRSTNAME, 1,4), 
since most last names should differ by 
the time you get to the ninth charac- 
ter. If two names are still the same at 
that point, I don’t need more than four 
characters of FIRSTNAME. You may 
disagree with the length of the sub- 
strings I have chosen, but you really 
don’t need the whole name. 


Creative Index Expressions 

As these examples show, an index ex- 
pression need not be limited to the 
fields in your database. You may use 
dBASE functions, constants, and even 
memory variables. However, using a 
memory variable in an index expres- 
sion is risky business because you may 
not be able to retrieve desired records 
if the memory variable changes value 
or becomes undefined from one ses- 
sion to the next. 

One of the most versatile functions 
in dBASE is the IIF (Immediate IF) 
function. It is often used in report writ- 
ing, but is just as useful as part of an 
index expression. For a quick introduc- 
tion to IIF, consider the following code 
fragment: 


IF mvar = ”PRN” 
mprint = .T. 
ELSE 
mprint = .F. 
ENDIF 


Those five lines of code can be reduced 
to one, courtesy of the IIF function: 


mprint = IIF(mvar = ”PRN”, 
otis A Pt) 


(Actually, due to the special nature of 
the code fragment shown above, you 
could also reduce it to one line even in 
dBASE II using STORE mvar = “PRN’”’ 
to mprint.) 

Suppose your database of address- 
ees contains two zip codes, one for a 
business address and one for a home 
address. You prefer to index on BUS_- 
ZIP, but if it is missing, you’d settle for 
HOME_ZIP. Your index expression 
simply becomes: 


IIF(bus_zip ) [], bus_zip, 
home_zip) 


There is one thing to keep in mind 
when you use functions like IIF in an 
index expression; the function must al- 
ways return a value with the same 
length. For that reason, we may not 
use, say, CITYNAME as a substitute for 
HOME _ZIP in our zip code example. 


Index In Descending Order 

You may have been surprised to dis- 
cover that dBASE III Plus does not have 
a built-in facility to index in descending 
order of key value. This oversight has 
caused a lot of confusion, particularly 
when even “gurus’”’ sometimes recom- 
mend workaround expressions that 
are unnecessarily cumbersome. 

First, consider the case of numeric 
fields. If we want to index in descend- 
ing order of a numeric field, all we 
need is an expression that involves 
subtracting the field from a large nu- 
meric constant. The result is a number 
that gets smaller as the value of the 
field gets larger. If the numeric field is 
nf, the index statement would be 
something like: 


INDEX ON 999999 - nf TO 
(ndxf ile) 


or better yet 
INDEX ON -nf TO (ndxfile) 


Now, consider the case of date 
fields. Most people will tell you that to 
index in descending order of dates, you 
must convert the date value in the 
form YYYYMMDD and subtract that 
from a large number. If the date field is 
df, the index statement they recom- 
mend reads like it came from an alge- 
bra textbook: 


INDEX ON STR(9999999 — 
YEAR(d£)*10000 + 
MONTH(df )*100 
+ DAY(d£)),8) 
TO (ndxfile) 


There is a much easier way. Note that, 
like most software, dBASE treats a 
date variable as a number. We know 
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+ 386 + 386 + 386 + 386 + 386 + 386 + 386 - 386 + 386 - 386 + 386 - 386 + 


y= 386 


SELF-INKING 
PRINTER RIBBON 


Awarded United States 


Mitesh een Patent #4701062 
AN tele Lasts 10-15 times longer 
S66-MATLAB,/ eite than the conventional ribbon. 


For printers using 1/2" width 
open spool ribbon: 


These and other protected-mode 32-bit 80386 programs are 
among the first to take advantage of the full power of the 386. 
They and practically every 386 protected-mode MS-DOS 
program that's shipping were done with MetaWare's compilers. 


It's no surprise. The recognized leader, MetaWare introduced the 
firstC and Pascal compilers that generate protected-mode 386 
code for running on any 386 MS-DOS machine (e.g., the Compaq 
386 or the IBM PS/2-80) over a year ago. High C ™ and 
Professional Pascal ™ are well-established and proven. 


@ Okidata-82A-83A-84- @ Dec LA 180/120 
92-93 @ Dec LA 30/IBM 1443 

@ Teletype-33, 35 @ Teletype-Model 40 

©@ Star Gemini 10X @ Texas Instrument 

@ Extel 800/810, 820, 880 


Smart software developers aren't waiting! \ndustry leaders such 
as Borland (ANSA) and Fox use MetaWare's compilers to get dra- 
matic increases in speed and functionality. Don't wait years for 
Microsoft's 386D0S—your competition will have a big jump on you! 

Expand your application to the large 32-bit address space and the 


full 32-bit registers of the 80386. Go with the long-standing leader. 
Contact MetaWare for your 80386 software solution today! 


CONTROLLED PRINTOUT 


(408)429-6382 telex 493-0879 
™ DEVICES, INC. 
Mats sre P.O. Box 869, Baldwin Road 
INCORPORATED Arden, NC 28704 


(704) 684-9044 e Telex: (Filmon-Aren) 577454 
Contact us by mail, phone or telex and we will 
forward you a brochure 


903 Pacific Avenue, Suite 201 * Santa Cruz, CA 95060 
The Clear Choice for Large Programming Projects —» 


Q8E + OBE - OBE + OBE + OBE » OBE + OBE + OBE > OBE - OBE > OBE - OBE + 9BE - OBE > OBE + OBE + OBE 


Tech Jeni 
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"The winner, though, was the 
e U S @) mM CAE/SAR 386. Its ESDI hard 


disk interface made it the 


i ae r i fastest of all the machines in 
rool mM = the disk access test." 


a PC Magazine 

Workstation soa 

Looking for a lightning- Based on a proven 386 and Xenix. Floating point 
quick 386 system that's motherboard, CAE/SAR 386 options are available for the 
tailored to your needs? systems come in dozens of _ Intel 387 chip. 
CAE/SAR Systems, Inc. will different configurations for Basic Unix/Xenix 
custom-fit you a 386 memory, disks, floating systems start at $3,495. 
system more powerful point and graphics. You 
than most on the market. can select high speed Get a system that fits you 
Whether it's a system drives (16 ms), 7OMb, perfectly. Call CAE/SAR 
designed for your program _140Mb, or 300Mb; EGA or Systems today for more 
development, artificial mono monitors and cards; — information. 
intelligence, CAE, or and 2.5Mb, 4.5Mb, or 8.5Mb 
pe isa design work, CAE/ 32-bit RAM— plus other CAE/SAR Systems, Inc. 
SAR delivers reliable, options! P.O. Box 50243 
powerful 386 workstations The CAE/SAR 386 systems Paqio Alto, CA 94303 


built for today's program- run Unix and DOS concur- (415) 949-3816 


mers. rently, and also run OS/2 ie eee 
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Figure 1. A Sample Output from DBNDXPO 


C)dbndxpo d:\darwin\*.??xX 


Filename 


Type Index Expression 


ADB2.NDX dB2 !($(NAME,1,5)+STATE 
FXXFINR.NDX 4dB3 projnum+fy 
FOXY.IDX FOX SUBS(lastname,1,8)+SUBS(firstname,1,4) 


CLIPME.NTX CLIP d_code+d_name 
MIPS.FOX Not an index file 


“Developing my application in C would have taken 6 months to a year, but in Actor it took 2 


months.” —Brian Fenske, Boeing Commercial Airplane Company 


Actually, you don’t have to make the 


“TH C ACIOR choice. Once C was ideal for all PC pro- 


gramming. Butit has been complicated by 
of ° windowing and graphical interfaces. Now 
windows development with C is difficult, 
time-consuming and error-prone. You 


to C ece 99 need a new language that simplifies win- 
dows programming. Introducing Actor® 


Actor is the first interactive object-oriented language made for commercial development. 
Its powerful browsers, inspectors and debuggers give you more insight into a windowing 
environment than C ever will. But your C work is not lost. C libraries can be linked to Actor. 
Plus, its procedural syntax is easy for C programmers to learn. 


Actor comes with windowing classes built in. Customize Actor's classes to create stand- 
alone windowing applications. And objects give you another layer of independence for a 
smooth transition to OS/2 and Presentation Manager. It’s the quickest and easiest way to write 
a windowing program. 


“You can write Windows programs much faster with Actor than with C or assembly language.” 
—PC Magazine, June 9, 1987 


© Runs with Microsoft Windows 1.04, 2.0 
and 386. Extended memory under 2.0 
and 386. 

¢ Pure, single-inheritance object-oriented 
language, incrementally compiled. 

© Dynamic linking to C, Pascal, Assembler, 
or Fortran libraries, Pass data in C 
structures. 

¢ Pascal and C-like syntax. 

¢ Programming tools: Browser, Inspector, 
Debugger, File Editor. 

¢ Full access to MS-Windows systems calls, 
multitasking, and DDE. 

Fast device-independent graphics: lines, 
shapes, icons, cursors, bitmaps, 
metafiles, Turtle graphics, sample 
control language using YACC. 

© 150 classes, 1500 functions, 
fully extensible. 


¢ Window styles: tiled, overlap- 
ping, popup, child, edit, dialogs. 
Controls: list boxes, scroll bars, 
buttons, check boxes. 

¢ Data structures: stacks, arrays, queues, 
lists, dictionaries, sets, sorting, hashing, 
intervals. 

¢ Al support: frames, symbols, 
dictionaries, lists, symbolic program- 
ming, functional arguments, Parsing 
and lexical analysis YACC compatible. 

¢ String manipulation: substring, concat, 
append, insert, remove, search. 

¢ 643-page manual includes tutorial and 
reference. 

* No license fees. Generates stand-alone 
applications. 

Fastest interactive OOL available. 

Fast incremental garbage collector. 


Actor $495 ¢ Academic price $99 ¢ Academic site license $99 ¢ Manuals for site 
license $35 ¢ New! Language Extension $99 ¢ Shipping $5 US, $25 Int’l 
The Whitewater Group 
Technology Innovation Center 
906 University Place, Evanston, Illinois 60201 
(312) 491-2370 


Actor is a registered trademark of The Whitewater Group, Inc. 
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that from the way dBASE stores dates 
in its files. We also know that from the 
fact that you can do arithmetic with 
dates. For example, 


date1 + number1 = date2 
date1 - number1 = date3 
date1 - date2 = number! 


Theoretically, you could add two dates 
but the result would be nonsensical, so 
dBASE gives you a “Type mismatch” 
error. 

Since we can, with few exceptions, 
treat dates as numbers, indexing in de- 
scending order of dates is really quite 
simple. We can’t have an expression 


INDEX ON -df TO (ndxfile) 


but if we subtract df from a small 
enough “number,” we have what we 
want and we don’t have to be algebra 
nuts to understand it: 


INDEX ON CTOD(”01/01/00”) - 
df TO (ndxfile) 


OOPS, I Can’t Recall 

the Key Expression 

There you are, building your dBASE 
application system masterpiece, creat- 
ing index files left and right. Two 
weeks later, you are staring at a direc- 
tory full of NDX files, and you can’t re- 
member the key expression used to 
build them. Of course, if you remem- 
ber which NDX files go with which DBF 
files, you can go into dBASE, use the 
files one at a time, and display the key 
expression you’ve forgotten with the 
help of dBASE’s DISPLAY STATUS 
command, but that’s a lot of work. 

What you need (other than a good 
memory) is a program that can be run 
from DOS that will read every NDX file 
you have on disk and report the key 
expressions. Enter DBNDXPO, a pro- 
gram I wrote some time ago. This 
small program displays the key expres- 
sion of index files created by dBASE III 
(and Quicksilver), dBASE II, Clipper 
and FoxBASE+. Figure 1 shows a 
sample invocation and output. 

The program is primitive and is 
based on empirical data obtained by 
creating a few index files and examin- 
ing their structure with DEBUG. I 
knew that each index file has a header 
record, and that the key expression is 
stored somewhere in that record. By 
experimentation, I found that the ex- 
pression began at the following loca- 
tions in the file: 


Software Byte Offset 


dBASE II 10 
FoxBASE+ 16 
Clipper 22 
dBASE III 24 
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Naturally, the program will produce 
erroneous results if any of the file 
structure changes. However, the pro- 
gram works as expected, as long as the 
key expression is longer than one char- 
acter. In fact, it is very handy for get- 
ting the key expressions of index files 
into the system documentation, and in 
making sense of all those index files 
you have on disk. 


Which NDX File Belongs to 
Which DBF File? 

dBASE application systems can use a 
hundred database files and several 
hundred index files. When looking at a 
directory full of database and index 
files, how do you tell which NDX files 
are associated with which DBF files? 
Normally, you can’t because of a defi- 


DBXDXPO is 
very handy for 
Setting the key 
expressions of 
index files into 
the system 
documentation 
and in making 


sense of all 
those files. 


ciency in dBASE; there is nothing in an 
NDX file that identifies the DBF file 
with which it is associated. dBASE 
should have placed a tag on an index 
file as soon as it is created that would 
carry the name of the associated DBF 
file. An internal function, say WHICH- 
DBF( ), would then return the tag 
stored in an NDX file, telling you the 
name of the DBF file to which it be- 
longs. Unfortunately, there is no such 
tag. 

As it turns out, Curtis Hoffman has a 
system that essentially does the same 
thing. Curtis has a shareware file 
called DB_DBUG2.ARC available from 
many bulletin board systems. DB_- 
DBUG2 contains eight dBASE utility 
programs, along with their Turbo Pas- 
cal source code. Two of those pro- 
grams, INSERT and PICKIT, depend on 
the fact that the header (anchor node) 
record of a dBASE NDX file contains a 
lot of unused space, specifically byte 
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offset 124-511. INSERT writes the 
name of a DBF file beginning at offset 
496 of the NDX file header record. 
Later, if you want to know the name of 
a DBF file associated with an index file, 
you run PICKIT, which simply reads 
the tag deposited by INSERT and dis- 
plays it to you. 

This approach can use improvement 
in two areas. First, INSERT and PICKIT 
do not accept wildcards. If you have to 
tag five index files with the same DBF 
name, you must run INSERT five 
times. Second, the two files could be 
combined into one, thereby saving disk 


space and leaving one less file to deal 
with. I wrote WDBF (short for WHICH- 
DBF) to correct these two deficiencies 
in Curtis’ program. WDBF is a C pro- 
gram that is faster and much smaller 
than either INSERT or PICKIT. It is a 
free program that also is available from 
most BBSs. ia 


P. L. Olympia, Phd, better known as 
“Dr. dBASE,” is a scientist with a doc- 
torate in Chemical Physics. He ts co- 
author of the book, dBASE Power: Build- 
ing and Using Programming Tools, 
recently published by Ashton-Tate. 


Write Better 


Turbo 4.0 Programs... 
Or Your Money Back 


You'll write better Turbo Pascal 4.0 programs easier and faster 
using the powerful analytical tools of Turbo Analyst 4.0. 
You get * Pascal Formatter * Cross Referencer * Program 
Indexer * Program Lister * Execution Profiler, 
and more. Includes complete source code. 

Turbo Analyst 4.0 is the successor to the 


acclaimed TurboPower Utilities: 


“Tfyou own Turbo Pascal you should own the Turbo 
Power Programmers Utilities, that’s all there is to it?” 


Bruce Webster, BYTE Magazine, Feb. 1986 


Turbo Analyst 4.0 is only $75. 


A Library of Essential Routines 
Turbo Professional 4.0 is a library of more than 400 state-of-the-art 
routines optimized for Turbo Pascal 4.0. It includes complete 
source code, comprehensive documentation, and demo 
), programs that are powerful and useful. Includes 
_{; * TSR management « Menu, window, and data 
a entry routines * BCD « Large arrays, and more. 


Turbo Professional 4.0 is only $99. 
Call toll-free for credit card orders. 
1-800-538-8157 ext. 830 (1-800-672-3470 ext. 830 in CA) 


Satisfaction guaranteed or your money back within 30 days. 


Fast Response Series: 

= T-DebugPLUS 4.0—Symbolic 
run-time debugger for Turbo 4.0, 
only $45. ($90 with source code) 

® Overlay Manager 4,.0—Use over- 
lays and chain in Turbo 4.0, only $45. 
Call for upgrade information. 


Turbo Pascal 4.0 is required. 

Owners of TurboPower Utilities w/o 
source may upgrade for $40, w/source, 
$25. Include your serial number. For 
other information call 408-438-8608. 
Shipping & taxes prepaid in US. & 
Canada. Elsewhere add $12 per item. 


«Be 


TurboPower Software 
P. O. Box 66747 
Scotts Valley, CA 95066-0747 
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LANSCAPE 


by Michael Cherry 


New LAN Products 
To Support PS/2 and 
Twisted-Pair Media 


his month we will look at new 

i product developments in two 
areas: PS/2 Micro Channel net- 

work interface cards and twisted-pair 


media support. 


IBM’s Token-Ring Adapter A 
Network Interface Cards 

IBM has introduced the Token-Ring 
Adapter A network interface cards for 
use with its new PS/2 Micro Channel- 
based systems. Many users first tried 
to use these cards with Novell Net- 
Ware in the same manner that they 
had used the IBM Token-Ring Adapter 
I and II cards, i.e., they first loaded 
TOKREUI.COM and then tried to load 
the NetWare shell ANET3.COM. This 
generally caused the PS/2 workstation 
to hang. 

The Token-Ring Adapter A cards 
will not work with TOKREUI. Instead, 
they require the IBM PC LAN Support 
Program. This program must be 
loaded first, then load the NetWare 
shell to use the PS/2s as workstations 
on a Novell network. 

Since IBM introduced the PS/2 Mi- 
cro Channel systems, LAN users have 
been searching for Micro Channel net- 
work interface cards other than IBM’s 
PS/2 Token-Ring Adapter A cards. 
PS/2 Micro Channel network interface 
cards for other LAN topologies also 
have been introduced. Currently, there 
are cards for ARCnet and Ethernet (@ 
la 3Com), and more are on the way. 
However, these cards must also be in- 
stalled carefully. 


Pure Data Network 

Interface Cards 

The first Micro Channel ARCnet net- 
work interface card, the PDIuC508 
card, was introduced by Pure Data. 
Pure Data has always had an excellent 
reputation in the ARCnet arena, and 
they deserve a lot of praise for getting 
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this excellent Micro Channel card to 
market so early. 

Micro Channel cards work quite dif- 
ferently from their XT and AT coun- 
terparts. Most notably, they lack 
jumpers or switches on the cards, so all 
interrupts settings and other address- 
ing must be set via software. 

The first step in working with Micro 
Channel cards is to copy the drivers 
from the interface card diskette to the 
backup of the PS/2 Reference Disk. 
This will allow the PS/2 to recognize 
the card and accept the setup. During 
setup, you will set an interrupt level, 
base memory address, and base I/O ad- 
dress. In addition, it is necessary to set 
a node address. When you first bring up 
the setup program, the node address 
will be at 128, and you can use the ap- 
propriate keys to increase or decrease 
the desired node address. 

The current Novell shells that are 
used with Pure Data or Standard Mi- 
crosystems ARCnet network interface 
cards will work in PS/2 Models 50 and 
60. They will, however, not work in a 
Model 80, but Pure Data can supply an 
ARCnet shell that will work with the 
Model 80. Novell also has shells that 
can be used with DOS 3.3 when run on 
PS/2 Micro Channel workstations. 

No doubt there will be other Micro 
Channel ARCnet cards available in the 
near future, but Pure Data has already 
proven that this card is reliable and 
workable in the Micro Channel 
environment. 

In addition to having the first Micro 
Channel ARCnet network interface 
card, Pure Data also has come up with 
the first ARCnet network interface 
card, the PDTC508, that fits into 
Toshiba T1100, T1200, and T3100 
portable microcomputers. This means 
that you can connect a Toshiba porta- 
ble as a node on an ARCnet network. 
Now, Toshiba portable users have an 
alternative to floppy disks or a serial 
communications link to transfer data 
between the portable and the LAN. 


3Com Etherlink MC 

3Com has developed a PS/2 Micro 
Channel interface card for use on 
3Com Ethernet local area networks. 
Again, there is an Adapter Description 
File that works with IBM’s Pro- 
grammable Option Select utility to 
ease installation and configuration. 
There are no hardware jumpers to set; 
interrupt level, I/O and memory ad- 
dresses, and external or internal (DIX/ 
BNC) transceiver operation are soft- 
ware-selectable. These cards work 
with the 3+ network operating sys- 
tem or other NetBIOS-compatible op- 
erating system. 

As of this writing, 3Com’s new 
Etherlink interface cards will not work 
with Novell NetWare shells. Novell has 
indicated that they are working on new 
NetWare shells for use with Etherlink 
Micro Channel network interface 
cards. 


Standard Microsystems ARCnet 
on Twisted-Pair 

Regular readers of this column know 
that we at HallComm NetWork Ser- 
vices are not fans of twisted-pair cable 
for LANs. However, we feel that new 
products are making this type of ca- 
bling more viable. 

One of these products is the new 
twisted-pair ARCnet network interface 
card from Standard Microsystems. 
This card fits in an expansion slot in 
any IBM PC, XT, AT, or compatible. 
Workstations with these cards can be 
connected together on a single 
twisted-pair segment in either a daisy- 
chain or multidrop configuration. The 
daisy-chain or multidrop segment can 
extend up to 400 feet. 

Expansion is permitted by connect- 
ing twisted-pair segments with a two- 
port twisted-pair repeater, and a 
twisted-pair network can be bridged to 
a coax network with a twisted-pair 
link. A typical system configuration is 
shown in Figure 1. 


3Com Ethernet on Twisted-Pair 
3Com has three products that provide 
10 mbps Ethernet operation on un- 
shielded twisted-pair cable. The three 
products are: 


@ PairTamer 
@ Multiconnect 
@ LanScanner. 


PairTamers are adapters that re- 
place the existing modular phone jack. 
Both the phone and the workstation 
are plugged into the PairTamer, allow- 
ing the voice and data signals to coex- 
ist on the cable system without inter- 
ference. Don’t confuse the PairTamer 
with a simple balun (impedance match- 

... continued on page 67 
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Simply the BEST C and 
Pascal on AT, 386, Sun, 
Apollo, RT, VAX, 370 


“The most rock-solid C compiler in the industry. Superb technical 
support and portability. Superior code generated.” 
Gordon Eubanks, Symantec — Q&A (386). 
“It simply works, with no trouble, no chasing strange bugs, and ex- 
cellent warning and error messages ... a professional product.” 
Robert Lerche, Bay Partners. 
“For large-scale software development, the highest quality C compiler 
available on the market today. Pragmas are great. Quality of 
support is exceptional.” Randy Neilsen, Ansa—Paradox (D0S,0s/2). 
“15% smaller and 15% faster than Lattice C.” 
Robert Wenig, Autodesk. 
“Our software is running anywhere from 30 to 50% faster than when 
compiled under Lattice.” David Marcus, Micronetics. 
“We switched from Lattice due to a 10% reduction in code size. The 
compiler is very stable.” Lee Lorenzen, Ventura Software 
— Ventura Publisher, marketted by Xerox Corp. 
“Best quality emitted code by any compiler I've encountered. Often a- 
mazing.” Bill Ferguson, Fox Software — FoxBase (386). 


“Messages sometimes pointed out type mismatches, incorrect-length 
argument lists, and uninitialized variables that had been undetected 
for years [in 4.x bsd].”. Larry Breed, IBM ACIS [RT PC]. 

“Diagnostics turned up bugs missed by other compilers. Rapid bug 
fixes by technical support, someone who knew what he was 
talking about. 80386 code is well optimized.” 

Tim Addison, Logistics Data Systems. 

“386 protected mode support is fantastic, especially the access to 
large amounts of memory. It's mainframe compute power on a 
PC.” Dan Eggleston, Viewlogic. 

“The preprocessor supplied with Professional Pascal is quite useful. 
The code quality and control over segmentation and memory mod- 
els are superior to MS Pascal.” Bob Wallace, QuickSoft. 


Check Out These Reviews 
¢ High C ™;: 


Computer Language February 1986, '87 

Dr. Dobb's Journal August 1986 

PC Magazine Jan. 27, 1987 (80386 version) 

Dr. Dobb's Journal July 1987 (80386 version) 

BYTE Magazine November 1987 (80386 version) 
* Professional Pascal ™: 

PC Magazine Dec. 29, 1985 

Computer Language .May 1986 

PC Tech Journal July 1986 


Journal of Pascal, Ada, & Modula-2. Nov.-Dec. 1986 
BYTE Magazine Dec. '86, June '87 (80386 version) 


Why MetaWare compilers 


* They are specifically designed for serious software developers. 

* They are reliable and robust: they don't break at every turn. 

* Their generated code is the best, or near best, on each architecture. 

¢ Their superior diagnostic messages help you produce better prod- 
ucts more quickly. 

* Your source can be ported with ease to the most popular systems. 

* You can link mixed-language modules from our compilers, others 

* You can benefit from high-level, personal technical support. 

* You can take advantage of the latest ANSI C extensions, and/or 
extensive Pascal extensions. High C has been tracking the ANSI 
Standard for two years; Professional Pascal will soon have a 
VS Pascal compatibility switch and several Apollo Pascal ext'ns. 

* You can take advantage of the latest 387 and Weitek 1167 support 
— we have the only compilers with Weitek real mode support. 


Power Tools for Power Users 


Ashton-Tate: dBase III Plus, MultiMate; Autodesk: AUTOCAD, AU- 
TOSKETCH (8087, '387, Weitek); Boeing Computer Services (Sun); 
CASE Technology (Sun); CAD/CAM giant Daisy ('86, '386, VAX); 
Deloitte Haskins & Sells; Digital Research: FlexOS; GE; IBM: 
4.3/RT, 4680 OS; Lifetree Software (Pascal): Volkswriter Deluxe, 
GEM-Write; Lugaru: Epsilon; NYU: Ada-Ed cmplr; Semantec: Q&A; 
Sky Computers; ... (Product names are trademarks of the companies indicated.) 


Industrial-Strength 


MetaWare C and Pascal compilers are designed for professional soft- 
ware developers. These tools are loaded with options to control 
them for special purposes. You can adjust the space-time trade-off 
in code quality. You can adjust external naming conventions to 
agree with linkers and operating systems. You can specify segment 
names for segmented architectures, and to help place code or data in 
particular places for embedded applications. You can select from 
five memory models for the 8086 family. And on and on. 


A Partial List of Optimizations 


Common subexpression and dead-code elimination, retention and re- 
use of register contents, jump-instruction size minimization, tail 
merging (cross jumping), constant folding, short-circuit evaluation 
of Boolean expressions, strength reductions, fast procedure calls, au- 
tomatic mapping of variables to registers (where advantageous), ... 


“Platform” — Code Quality 


Sun,Apollo,SGI— 18%, 3%, 26% > resident compiler (Dhrystone). 
PC: DOS, OS/2 — 3-10% > Microsoft C; 30% > MS Pascal, LatticeC. 
386 32-bit DOS— no competitors, since November, 1986. 

286, 386 UNIX — 66% better than pec (Dhrystone, 386). 

VAX VMS — =~ DEC's excellent C and Pascal; better features. 
VAX Ultrix — 19% > pec (Dhrystone); much > Berkeley Pascal. 
RT PC/4.3bsd — 89% > the original port of pec (Dhrystone). 

370 CMS,UNIX— much better than any C, and VS Pascal. 

AMD 29000 — >40,000 Dhrystones! Available in Q2, cross. 


(408) 429-6382, telex 493-0879. Since 1979. 


Mets AN, Ista” 


INCORPORATED 
903 Pacific Avenue, Suite 201 ¢ Santa Cruz, CA 95060-4429 


The Clear Choice for Large 


© 


Programming Projects — + ::. 


1987 MetaWare Incorporated. MetaWare, High C, Professional Pascal, and DOS Helper are 
trademarks of MetaWare Incorporated. Others and their owners are duely respected. 


FLOPPY DISK. 
- Fills time between coffee breaks 
- Makes a hard disk seem fast 


- Your computer appears busy 
(even if you aren’t!) 


- Wears out moving parts 


...for YOUR demanding tasks. 


SURPRISE! Neither is memory mapped, so they don’t 
affect your precious Main Memory. Both retain data indefi- 
nitely - even with the computer turned off. 


THE SEMIDISK SOLUTION. You could invest in a 
series of “upgrades” that turn out to be expensive band-aids 
without solving your real problem. Even those “Ac- 
celerator” and “Turbo” boards do little to speed up disk- 
bound computers. If your applications spend too much time 
reading and writing to disk (and whose don’t?), you won’t 
want to settle for anything less than a SemiDisk disk 
emulator. The SemiDisk comes in 512K and 2Mb capacity. 
More boards may be added to make up to an 8 Megabyte 
SemiDrive! 

SPEED THAT’S COMPATIBLE. PC, XT or AT, if you 
need speed, the SemiDisk has it. How fast? Recent ben- 
chmarks show the SemiDisk is from 2 to 5 times faster than 
hard disks, and from 25% faster (writing) to several times 
faster (random reads) than VDISK and other RAMdisk 
software that gobble up your main memory. 

MEMORY THAT’S STORAGE. Using our small exter- 
nal power supply, with battery backup, your data remains 
intact through your longest vacation or even a seven-hour 
power failure! 


SEMIDISK Disk Emulator. 

- Gets that job done NOW 

- Makes a hard disk seem slow 

- Maximizes your productivity 
with anything from databases 
to compilers 

- Totally silent operation 


CELEBRATE WITH US! Now, SemiDisk celebrates its 
fifth birthday with a special offer for IBM-PC owners. Buy 
a SemiDisk now and we’ll include an 8 MHz V-20 micro- 
processor (replaces the 8088) to make your new SemiDisk 
run even faster. Don’t need the V-20? We’ll take $20 off 
the price of your Battery Backup Unit! 


512K 2Mbyte 
IBM, PC, XT, AT $495 $ 795 
Epson QX-10 $495 $ 995 
S-100 SemiDisk II $795 $1295 
S-100 SemiDisk I $299 anne nne nnn nnn 
TRS-80 II, 12, 16 $495 $ 995 
Battery Backup $130 $ 130 


Someday you’ll get a SemiDisk. 
Until then, you’ll just have to...wait. 


SemiDisk 


SemiDisk Systems, Inc., 11080 S.W. Allen Blvd., Beaverton, Oregon 97005 (503) 626-3104 


Coaxial Cable LAN 
Twisted 

Pair 

Link 


—— Twisted Pair Segments 
—=—= Coaxial Cable 
Terminator 


Figure 1. A typical ARCnet twisted-pair network 


b PairTamer 
aaae Thin Coaxial Cable 
—— _ Twisted Pair Cable 


Figure 2. A typical 3Com twisted-pair network 
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Continued from page 64 

ing transformer). We have examined 
the electronics of the PairTamer and it 
is more then a balun, as is reflected in 
the cost. 

The Multiconnect is a repeater with 
slots for 15 modules. Any combination 
of coaxial, twisted-pair, or fiber-optic 
wiring can be used by selecting the ap- 
propriate module. 

The LanScanner is a hand-held, bat- 
tery-powered test instrument that en- 
ables cable technicians and network 
administrators to measure twisted- 
wire cable characteristics and deter- 
mine whether or not a cable system 
can support data transmissions. A typi- 
cal 3Com twisted-pair network is 
shown in Figure 2. Note that 3Com al- 
lows you to go from the twisted-pair, 
via the PairTamer to a segment of co- 
axial cable. 


Anything Goes? 

Does this mean that anything goes— 
can any twisted-pair cable be used? The 
answer is no! Both Standard Microsys- 
tems and 3Com have published the 
technical specifications for the twisted- 
pair cable system, and these must be 
met. The specifications are available 
from the manufacturer and should be 
checked prior to deciding to use 
twisted-pair wiring. In the case of 
3Com, you will want to use the Lan- 
Scanner to test the existing twisted- 
pair wiring to determine its suitability 
for use with 3Com equipment. oO 


Michael Cherry is Vice President of 
Technical Support for HallComm 
Network Services (HNS), a company 
devoted exclusively to designing and 
implementing LAN systems. 


Product Information 


HallComm NetWork Services 
8101 E. Prentice Ave., Ste. 304 
Englewood, CO 80111 

(303) 770-6387 


Pure Data 

1740 S. I-35, Ste. 140 
Carrollton, TX 75006 
(214) 242-2040 


Standard Microsystems 
Corporation 

35 Marcus Blvd. 
Hauppauge, NY 11788 
(516) 273-3100 


3Com 

3165 Kifer Rd. 

Santa Clara, CA 95052-8145 
(408) 562-6400 
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New Products 


When contacting vendors, 
please mention that you 
read about their products 
in Micro/Systems. 
Manufacturers who 
would like to have their 
products listed here should 
send their new product re- 
leases to the Managing 
Editor, Micro/Systems, 
501 Galveston Drive, Red- 
wood City, CA 94063. 


PC-Compatible 
Products 


Card Offers Bus 
Analysis 
Applied Physics, Inc., has 
released the BusTrak Mi- 
crosystem Bus Analyzer for 
microcomputer diagnostics 
and hardware and software 
development. Unlike many 
other test systems, A sin- 
gle XT/AT BusTrak card 
combines many of the fea- 
tures of logic analyzers, 
code debuggers, and PC 
testers. The card can be 
inserted into the develop- 
ment system, or it can be 
operated from a second 
system to perform diagnos- 
tics or advanced post pro- 
cessing. BusTrak has a 
window-based menu for 
easy operation and will sup- 
port a mouse. The BusTrak 
also can capture from 
8,000 to 32,000 bus states 
in real time, depending on 
the computer model. Un- 
like software debuggers, 
BusTrak captures all bus 
signals, Flexible triggering 
allows the user to set any 
breakpoint condition. Op- 
tions include address or ad- 
dress range, data bus, I/O 
or memory access, reads or 
writes, and combinations. 
Post processing of cap- 
tured data offers an alter- 
native to scrolling through 
screens or bus states. The 
user shell can set the cap- 
tured data for you and find 
specific events. 

The XT/AT BusTrak is 
scheduled for release in the 
first quarter of 1988. Addi- 
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tional versions for IBM’s 
PS/2 and the Macintosh II 
are scheduled for release in 
the second quarter. Prices 
range from $1,500 to 
$2,500, depending on the 
model. For more informa- 
tion, contact Applied 
Physics, Inc., Purdue Re- 
search Park, Lafayette, IN 
47907; (317) 497-1718. 


Tape Backup System 
Taps PS/2 
Multitasking 

Maynard Electronics, Inc., 
has begun shipping the 
MaynStream 60, a high- 
performance, 60-megabyte 
tape backup system for the 
IBM PS/2 models 60 and 
80. The system includes 
the drive, adapter card, ca- 
bles, data cassette, and 
control software. The 
MaynStream 60 fits into 
the 54-inch opening of the 
Model 60 or 80, leaving 
room for a 5%-inch hard 
disk. Both the adapter and 
the software take advan- 
tage of the Micro Channel 
bus architecture, including 
multitasking to allow simul- 
taneous reading from the 
hard disk while writing to 
tape, with automatic read- 
ing after writing to assure 
the accuracy of each back- 
up. MaynStream’s soft- 


The Model 225 from M-Test 


ware supports Novell, 
3Com, IBM PC Network, 
and Token-ring LANs with 
remote backup/restore of a 
file server from any work- 
station, including file-by-file 
backups without shutting 
down the network. 

Maynard offers a variety 
of PS/2 backup configura- 
tions, including 20 MB 
($1,395) or 60 MB 
($1,695) portable cassette 
systems, and 60 MB 
($2,095) or 150 MB 
($2,295) portable %4-inch 
cartridge tape backup sys- 
tems. The internal 20 MB 
($995) cassette system and 
150 MB ($1,995) cartridge 
system can mount inside a 
Model 60 or Model 80. 

For more information, 
contact Maynard Elec- 
tronics, Inc., 460 E. 
Semoran Blvd., 
Casselbury, FL 32707; 
(305) 331-6402. 


Other Hardware 
Products 


M-Test Offers Low- 
priced Serial 

Breakout Box 

M-Test Equipment has re- 
leased its Model 225, a 
high-quality RS-232C serial 
breakout box that includes 
parallel interface testing 
capabilities. The Model 
225 has 52 LEDs that give 
4 state signal indications. 
Twenty-six in-line switches 
and 52 sockets allow 
breaking and redirection of 


25 lines plus one unas- 
signed line. A battery simu- 
lates high or low signals. 
The Model 225 sells for 
$229. For more informa- 
tion, contact M-Test 
Equipment, P.O. Box 
146008, San Francisco, CA 
94114; (415) 864-1076. 


New Software 
Products 


New Optimizing 
Compiler Produces 
Tight Code, Fast 
Watcom Group, Inc., has 
just released C6.0, an op- 
timizing C compiler and 
development system that is 
ideally suited for large 
memory models and float- 
ing-point computation. The 
compiler and development 
systems also permits ex- 
tensive fine-tuning with a 
variety of user options , 
such as in-line substitution 
of machine code for per- 
formance-critical areas. 
Watcom C6.0 supports 
small, medium, compact, 
large, and huge memory 
models, and NEAR, FAR, 
and HUGE keywords. 
Dhrystone tests on a PC 
reveal that C6.0 will gener- 
ate 992 bytes in 89 sec- 
onds on a small memory 
and 1001 bytes in 18 sec- 
onds. Included in the C6.0 
package is a full C optimiz- 
ing compiler, a source edi- 
tor, full-screen source-level 
debugging, a full ANSI run- 
time library, an overlay 
Inker, an object librarian, 
MAKE, and a disassembler. 
The package includes Ex- 
press C, also available sep- 
arately, which provides a 
seamless development 
environment with diagnos- 
tics. Express C has error 
checking that uncovers 
bugs in the ‘‘correct’’ code, 
and includes MAKE, a disas- 
sembler, an object librar- 
ian, and an overlay linker. 

Watcom’s C6.0 has a list 
price of $495 and Express 
C retails for $125. Intro- 
ductory discounts are avail- 
able for a limited period. 
For more information, con- 
tact Watcom, 415 Philip 
St., Waterloo, Ontario, 
N2L 3X2, Canada; (519) 
886-3700. 
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VERY HIGH RESOLUTION 
COLOR and MONOCHROME 
DISPLAY SYSTEMS 


¢ Based on the TMS34010 32 
bit graphics CPU - Amazing 
performance at a reasonable 
price. 

© 800 by 1024 display, 2 bits 
per pixel for high resolution 
grey scale. 


e PC, XT, and AT Compatible! 

* FAST hardware emulation 
for CGA, Monochrome, and 
Hercules graphics modes. 


¢ Primary operating software 
supplied. DGIS based sup- 
port available for very high 
performance interfaces to 
CAD, simulation, and 
windowing application. 
*SPECIAL LIMITED TIME OFFER: PC Tech is offering the 
complete video system (monitor shown above, graphics adapter 
card, cables and emulation software) for a special introductory 
price of $995 plus shipping and handling. Bank card orders 


COMPLETE SOURCE CODE INCLUDED! 
ICXPDS: eXchanger now supports the 5 1/4”iPDS format. Manipulation 
of ISIS-II files using your computer system was never easier. 
ICXMDS: Same as ICXPDS, but for MDS 8" systems. 
IMXPDS: ReadsMrites 5” iPDS disks on PC's and AT's. 


TELEDPLUS: Enhanced serial file transfer program for CP/M, ISIS, 
or MS-DOS. 


ISE: Emulator gives the CP/M and MS-DOS user access to all the ISIS-II 
languages and utilities. 

ACCELER 8/16: CP/M-80 emulator for MS-DOS. Enables PC's 

to run ISE. (no source code, V-20 incl.) $89 each 

$250 any 3 above 


UDI: The 8086 ISIS Emulator runs all UD! applications. 


ZAS Development Package: Z-8 and Z-8000 


Assembler for CP/M, ISIS, and MS-DOS. 


welcome. 
Designed, Sold and Serviced By: 


See parE 
904 N. 6th St. 
Lake City, MN 55041 
wa (612) 345-4555 


PC, XT, and AT are trademarks of International Business Machines Corp. 
DGIS is a trademark of Graphic Software Systems, Inc. 


Request a catalog of our products! 


Copyrights CP/M Digital Research. Inc 
ISIS-I1 and iPDS Intel Corp. MSODOS Microsott 


| ~ Western Wares 303-327-4898 


BoxC # Norwood. CO 81423 


CONFIG.SYS and use ANSI.SYS to change the 
appearance of MS-DOS. Taming MS-DOS Second 
Edition includes ready-to-use BASIC programs that 
enhance MS-DOS. You can rename directories and 
disk volumes, change file attributes, check available 
RAM and disk memory, display a memory-resident 
clock, and assign MS-DOS commands to ALT keys. 
The programs, including batch files and MS-DOS 
enhancements, are available on disk with full source 
code. 


TO ORDER mail this coupon with payment to M&T 
Books, 501 Galveston Drive, Redwood City, CA 94063 
or CALL TOLL FREE 1-800-533-4372 (In CA 800- 
356-2002). 


Yes! Please send me Taming MS-DOS, 2nd Edition with 


Updated and Expanded to cover MS-DOS 
3.3 — The 2nd Edition is better than ever 


Taming 
MS-DOS 


2nd Edition 
by Thom Hogan 


"TAMING 
MS-DOS 


Tools and Techniques 
fe rh 


A new and improved version of Hogan’s popular 
first edition, Taming MS-DOS Second Edition has disk at $34.95 
been updated to cover MS-DOS 3.3. You'll learn Book only at $19.95 _____ 
how to maximize your batch files with routines subtotal 
using redirection, filters and pipes, and routines CA residents add sales tax —%________ 
that prevent accidental reformatting of your hard $2.25 per book shipping & handling—____ 


disk, redefine function keys, and locate files within Total________ 
subdirectories. Other batch files will implement an Name 
MS-DOS help system, including help text files, a Address 
menu system that interprets keyboard input, and a City State Zip 
routine for quick redefinition of function keys. iduakc (Ehwaah Clinc> ae 
You'll also learn how to create configurable CardNo,__..o.4.4.._+_+_o64§=_=  &xp, Date 
AUTOEXEC.BAT files, and how to customize Signature 
* Also available at your local bookstore 4A 
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Classifieds 


Micro/Systems Journal accepts Classi- 
fied Ads. The charge is $6/line (3 lines 
minimum, 7 lines maximum), 40 charac- 
ters max./line. Three times frequency $15/ 
line; six times $25/line; non-profit clubs 
$2/line. Logos, special type, etc. are extra 
charge. Check must accompany ad copy. 
Send to M & T Publishing Inc., 501 Gal- 
veston Dr., Redwood City, CA 94063. 


GMX20 MICRO: Uniflex OS, C Com- 
piler, VSAM, Editor, et al. 16.7 MHz, 
68881 socket, 25MB, 720K floppy. New 
Cond. $3,500 obo. Marc Talisman: days 
(714) 582-9100. 


HARD TO FIND COMPUTER SUP- 
PLIES For Software Developers and 
Power Users. IBM style binders & slips. 
Vinyl B&S. Floppy Pgs., disk envs., custom 
prtg. MUCH MORE. FREE CATALOG. 
Anthro Syst., 376 East Saint Charles Rd., 
Lombard, IL 60148; (312) 629-5160, 
(800) 332-5669. 


“Don’t leave home without it.”’ 
Credit-card size reference to 56 PC-DOS 
cmds. $3. Packet Press, 14704-M Seneca 
Castle Ct., Gaithersburg, MD 20878. 


DISK CONVERSION: Most CP/M and 
MS-DOS formats. 48 hour turnaround. 
Reasonable rates. Personal service. For in- 
formation call or write: RH Associates, 
2211 Mark Ct., Silver Spring, MD 20910; 
(301) 587-6230. 


MS/J LISTINGS ON DISK 

All the computer listings printed in Micro/ 
Systems are available on MS-DOS floppy 
disk. Programs from each issue are avail- 
able for $14.95 each. For more informa- 
tion, contact: 

Tim Trickett 

M&T Books 

501 Galveston Drive 

Redwood City, CA 94063 

(415) 366-3600, ext. 221 


Kaypro/Osborne CP/M mouse driver, 
$40, faster and easier cursor movement in 
WordStar, SuperCalc, graphics, etc. Pro- 
gressive Products, (408) 265-5490, 1797 
Nelson Way, San Jose, CA 95124. 


SQL.PAS 

Make stack, queue, and list standard data 
types in Turbo Pascal ($9.95). PSW, Box 
10072, McLean, VA 22102-8072. 


WE WELCOME YOUR ARTICLES 


We are always glad to hear from potential authors 
who have an interesting tale to tell. If you are 
interested in contributing an article that relates to 
local area networks, multiuser systems, or com- 
puter programming, please contact us. For exam- 
ple; in upcoming issues we plan to discuss: 


e@ PC Multiuser Operating Systems 


@ UNIX on the PC 


@ Graphics on the PC 
@ 386 Software Development Tools 
@ Database Options 


@ Troubleshooting Local Area Networks 
@ Modem Standards and Compatibility 
@ High-Capacity Information Storage 


We would welcome your contributions on these 
and related topics. Please contact: 


Tom Woolf 


Managing Editor 
Micro/Systems 

501 Galveston Drive 
Redwood City, CA 94063 
(415) 366-3600 


70 = Micro/Systems 


Advertiser 


Index 

Aker Corporation ..............csssceeeee 3476 
American Cybernetics................++ 51 
Andsor Research Inc. ................2+ 15 
Austin Code Works ...............ss0000 his 
ASCIi—Automated Software 

Conceptaictcccs. cess. sssascueas ates aeseeace 13 
BG Computer Applications ........... 31 
Blaise Computing Inc.................++ 25 
Bytel Corporation..............cs..ccs008 59 
CC. Software nies oicn ei eiees 55 
CAE/SAR Systems Inc......... en GE 61 
Classifieds escecsegscosscecssssssecssseus 70 
Cobalt! Blues ec icrece sucess ec cecee cescse 35 
Computer Innovations ...... Rea ae 39 
Controlled Printout Devices ......... 61 
Digiboard on 2c ee, aoe 27 
Digital Research Computers....... 32 
Digital Research Ince. .................. C-1 
Ecosoft Ines cia ie 52 
Essential Software .............00000666C-4 
Gimpeleciiisieeccceatieecaanene 18 
Harvard Softworks ................00+0+ 43 
TGC rears assets a tceaas sceuuegren es 57 
Interface Group Ince. ................006 47 
Macrotech International .............. 7 
Magna Carta Software.............+0++ 55 
MetaWare Inc............cscceeeeeeees 61,65 
Micro/Systems.............ccsseeeseeeeeee 40 
MicrOWay eicses.0n cscccoseuncouseseaseause 16 
MET Books.o 2c N Sa 45,49,69 
Nanosoft Associates ..............es0008 42 
Novell Development Division........ 2 
NWP Intelligent Solutions, Inc. ....46 
PC Techie. oc eee ais 69 
Periscope Co. Inc. ............s0seeeseeee 5 
Quarterdeck Office Systems ........ C-3 
Schoenbaechler.............00+++ passes PEs $5) 
Semi-Disk Systems...............-...-.- 66 
SLR Systems ...............scceeesseceesee 9 
Slicer Computer ...............cceeeseeees 48 
SOftfOCUS ees ocsaei at ae eestaascesseans 23 
Software Connections Inc......... fespta ys) 
Solution Systems............ccsesseeeeees 29 
Stony Brook Software Inc. ........... 72 
Sunny Hill Software ........... aerpuaal Ue 
Thomas-Conrad Corporation......... 14 
Turbo Power Software............. aos 
Turbo Tech Report .............sesceeeeee 49 
Vermont Creative Software........... 1 
Western Wares ..........csssceessesceesees 69 
Whitesmiths’ Ltd..............cccceeeee .10 
Whitewater Group .............0..eeseeee 62 
Wyte Corporation .............ssccseeeeee 48 


Apri 1988 


C CODE FOR THE PC 


source code, of course 
C Source Code 


Bluestreak Plus Communications (two ports, programmer’s interface, terminal emulation) . . . . $400 
CQL Query System (SQL retrievals plus windows) ...... 2... - eee eee ee ee $325 
GraphiC 4.1 (high-resolution, DISSPLA-style scientific plots in color & hardcopy) cia & « 19820 
Barcode Generator (specify Code 39 (alphanumeric), Interleaved 2 of 5 (numeric), or PC) ... $300 
Greenleaf Data Windows (windows, menus, data entry, interactive form design). ........ $295 
Aspen Software PC Curses (System V compatible, extensive documentation) .......... $250 
Ravana Cu MacWindows) 1. : sp 0s whi som d we i Gwe oe eR ER Ew Os HOR $200 
Essential resident C (TSRify C programs, DOS shared Eibraries), (% ised... sors ee en te ae ee $165 
Essential C Utility Library (400 useful Cfunctions) .. 2... 1... 2. ee ee eee . $160 
Essential Communications Library (C functions for RS-232-based communication systems) . . . . $160 
Greenleaf Communications Library (interrupt mode, modem control, KON-XOFF) ....... $150 
Greenleaf Functions (296 useful C functions, all DOS services) .........-....-.2., $150 
OS/88 (U*+x-like O/S, many tools, cross-development from MS-DOS) ........ ee 
Turbo G Graphics Library (all popular adapters, hidden line removal) .........2.2.. $135 
American Software Resident-C (TSRify C programs) ................284-. . $130 
CBTree (B+tree ISAM driver, multiple variable-length keys)... .........220-.., $115 
PC/IP (CMU/MIT TCP/IP implementation for PCs) . 2 2 25 2. et wt ts $100 
B-Tree Library & ISAM Driver (file system utilities by Softfocus) . . .. 2... .....-.. $100 
The Profiler (program execution profile tool)... .........04. a $100 
Entelekon C Function Library (screen, graphics, keyboard, string, printer, etc.) ......... $100 
Entelekon Power Windows (menus, overlays, messages, alarms, file handling, etc.) . .. . . s «= $100 
Wendin O/S Construction Kit or PCNX, PCVMS O/S Shells. . 2... 2... eee ee $95 
QC88 C Compiler (ASM output, small model, no longs, floats or bit fields, 80+ function eae . . $90 
JATE Async Terminal Emulator (includes file transfer and menu subs yaeny som eS ae Hy goes $80 
MultiDOS Plus (DOS-based multitasking, intertask messaging, semaphores) Bi ee aa $80 
ME (programmer’s editor with C-like macro language by Magma ee) ee ee eee ee $75 
WKS Library (C program interface to Lotus 1-2-3 program & files) . . ea sees bs te wee $65 
Quincy: (interactive’C interpreter)... 56 @ = 60g les) yo on Sy GS weed KG ew me $60 
EZ_ASM (assembly language macros bridging Cand MASM).............. oa « » $60 
Pilree (parsé trée management) « 2 sss 2G bw He He EE Ee a i 5 &% = $60 
HELP (pop-up help system builder) . . 2 1. 1 1 ee ee $50 
Multi-User BBS (chat, mail, menus, sysop displays; uses Galacticomm modem card) . saa cw = $50 
Heap Expander (dynamic memory manager for expanded memory) ............... $50 
Make (macros, all languages, built-in rules) . 2... 1... 2... ee ee ees es @ & $50 
Vector-to-Raster Conversion (stroke letters & Tektronix 4010 codes to bitmaps) BRO eS ecpura on ee $50 
Coder’s Prolog (inference engine for use with C programs) ....... Gh e? Hoey GPG Re ee Wye $45 
C-Help (pop-up help for C programmers ... add yourown notes) .............004. $40 
Biggerstaff’s System Tools (multi-tasking window managerikit))”... sis "a opis GP 2 SG ee els $40 
CLIPS (rule-based expert system generator, Version 4.0)... 2... 2... ee ee ee ee ee $35 
TELE Kernel (Ken Berry’s multi-tasking kernel) . . 2 2... 2. eee ee eee ee $30 
TELE Windows (Ken Berry’s window package)... ......... oe ase ey epcap R? ey ee $30 
Clisp (Lisp interpreter with extensive internals documentation) ...............2.4. $30 
Translate Rules to C (YACC-like function generator for rule-based systems) ........... $30 
6-Pack of Editors (six public domain editors for use, study & hacking). ....... Sab: Coe OSU 
ICON (string and list processing language, Version 6 and update)... ..... Be ea tateth ag Apo 
LEX (lexical analyzer generator) ..... 1... 2-2. eee eee eee ene om ew a 120 
Bison & PREP (YACC workalike parser generator & attribute grammar preprocessor). ...... $25 
AutoTrace (program tracer and memory trasher catcher) Rel Gees fs seo erties aed Gy Gs $25 
C Compiler Torture Test (checks a C compiler against K&R)... ... 2... ee ee $20 
Benchmark Package (C compiler, PC hardware, and Unix system) ............... $20 
TN3270 (remote login to IBM VM/CMS as a 3270 terminal on a 3274 controller)! * . i ws) it ae $20 
A68 (68000.cross-assembler) . 2 2 2 a sc Gow wom OK ew eG eR ww a me eH eee $20 
List-Pac (C functions for lists, stacks, and queues) ..............2.., SS a et 2920 
XLT Macro Processor (general purpose text translator) ee a Rare ge ee ae ee ee $20 
Data 

WordCruncher (text retrieval & document analysis program)... .......--e.00- se a 2ro 
DNA Sequences (GenBank 52.0 including fast similarity search program) ........... $150 
Protein Sequences (5,415 sequences, 1,302,966 residuals, with similarity search program) ..... . $60 
Webster’s Second Dictionary (234,932 ’ words) eee ee ee ee $60 
U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state ponndany: points) . . . $35 
The World Digitized (100,000 longitude /latitude of world country boundaries) smd eked Res igs, wis $30 
KST Fonts (13,200 characters in 139 mixed fonts: specify TEX or bitmap format) ..... « 4 tice $30 
USNO Floppy Almanac (high-precision moon, sun, planet & star posesons) 5 eh ile wm, lee a ew WDD 
NBS Hershey Fonts (1,377 stroke characters in 14 fonts) . . sphiod SLs sorlin eres We tees ASLO) 
U. S. Map (15,701 points of state boundaries) ... 1... 2. ee es $15 
The Austin Code Works Voice: (512) 258-0785 
11100 Leafwood Lane acwlinfo@uunet.uu.net BBS: (512) 258-8881 
Austin, Texas 78750-8409 USA FidoNet: 1:882/12 


Free shipping on prepaid orders For delivery in Texas add 7% MasterCard/VISA 


I have come to bury 


i 
we 


C, sir, not to ¥ 
praise it. 


C served us well in the days of kilobytes and kilohertz. It was the only 
language we could implement efficiently on our newborn microcom- 
puters. But with today's mega-machines, shouldn't we demand more 
from our compilers? 

Modula-2 increases productivity by catching your errors at compile 
time. You'll easily modularize and structure your programs, driving the 
hordes of barbaric bugs into the hinterlands. And Modula-2 does all 
this without taking away the low-level machine access that made C so 
popular. 

Until now, you had to pay a price for the Modula-2 advantages — per- 
formance just didn’t measure up to C But we've changed all that. In 
a suite of benchmarks developed by PC Week: 


v7, 
, 


Stony Brook Modula-2 outperforms 
the best C compilers on the market 


(and no other Modula-2 compiler even comes close). 


Stony Brook Modula-2, for 80x86 machines, produces Microsoft-compatible 
objects, and fully supports both Microsoft Windows and OS/2. It’s the only high- 
level language compiler that lets you write dynamic link libraries. It handles 32- 
and 64-bit real numbers with in-line 80x87 coprocessor instructions or software 
emulation. And Stony Brook Modula-2 supports six memory models and mixed 
model programming, 


You might want to bury your C compiler 
once you have used Stony Brook Modula-2, but 
you won't have to, We made it possible to 
directly call C and other lanquages from 


(onal C V4 
Modula-2, so you won’t have to throw away Magnifier 0.05 006 0.05 #4005 

our investment in C code. For Loop 0.28 0.73 0.44 0.68 
y While Loop 0.35 0.75 0.49 0.66 
Repeat Loop 0.33 0.68 0.38 0.66 
S Literal Assign 0.33 0.97 0.60 0.94 
, friends, pr . a Memory Access 0.33 1.04 0.55 1.00 
papi A Kp, gies od vie kg Real Arithmetic 4.68 13.40 3.73 2.96 
your ears. Call us or write for more information Real Algebra 4.18 12.87 3.07 3.64 
; Vector 0.77 1.75 1.21 1.26 
and to find out how you can get a demo Equal It 0.66 1147 093 1132 
compiler. Unequal If 0.66 1.43 0.99 1.32 
No Parameters 0.33 0.60 0.34 1.04 
Value 0.50 0.71 0.60 1.21 
Reference 0.61 0.77 0.66 1.21 

Real Maths 3.90 4.61 7.85 18.51 =z 


for our split-screen text editor for $195. The development package includes all 
INC. of the above plus an automatic make utility, a symbolic debugger, and run- 


S time library sources for $345. MasterCard and Visa accepted. Add $5 for ship- 


SOFT WA R E ping in North America, $25 for overseas shipping. 
Forest Road, Wilton, New Hampshire 03086 @ (603)654-2525 Ask for Cleopatra. 


How to tell the difference 
between DESQview’2.0 and 
any other environment. 


Geiecting DESQview, 
the environment of 
choice, can give you the 
productivity and power 
you crave, without the 
loss of your old pro- 
grams and hardware. 

If you like your existing 
programs, want to use 
them together, transfer 
data between them, 
print, sort, communi- 
cate with or process- 
in-background, yet still 
have the need to keep 
in place your favorite 
PC(8088, 8086, 80286 
or 80386), DESQview 

is the “proven true” 
multitasking, multi- 
windowing environ- 
ment for you. Best of all, DESQview 2.0 is here now, 
with all the money saving, time saving, and productiv- 
ity features that others can only promise for the all- 
too-distant future. 

And with DESQview’s new graphics enhancements 
for Hercules, CGA, EGA, and VGA, Version 2.0 still 
offers the same award winning and pioneering fea- 
tures for programs that earned DESQview its leader- 
ship, only now you can also run desktop publishing 
programs, CAD programs, even GEM-™ Topview-™' and 
Microsoft Windows-™ specific programs. In some cases 
you’ll add as little as 10-40K to your system overhead. 
Now you can have multi-tasking, multi-windowing, 
break the 640K habit too and still get an auto dialer, 
macros, menus for DOS and, for advanced users, a new 
complete application programmer's interface capabil- 
ity. No wonder that over the years, and especially in 
recent months, DESQview, and now 
DESQview 2.0 have earned extrava- INFO 
gant praise from some of the most | WORLD 
respected magazines in the industry. | REPORT CARD 

“Product of the Year” by readers ° 
vote in InfoWorld. . DESQview 2.0 

“Best PC Environment” by popu- 
lar vote at Comdex Fall in PC Tech 
Journal's “System Builder” Contest. 


One picture is worth a thousand promises. 


“—T wouldn't want to run an IBM 


or compatible 
computer without 
DESQview’—Info- 
World, Michael Miller. 

“A colossus among 
windowing environ- 
ments”... “will run 
almost anything’—PC 
Week, Marvin Bryan. 

“Windows, prom- 

fata. ae ises, but DESQview 
ESliview 7 delivers’—MICRO- 
TIMES, Birell Walsh. 

No other environ- 
ment has consistently 
pioneered features, open- 
ness, and productivity. 
See for yourself. Send in 
the coupon. The possi- 
bilities are endless with 
DESQview 2.0. 

Attention Programmers: For more information 
about Quarterdeck’s API, and future 386 program 
extensions, call us today. 


SYSTEM REQUIREMENTS 

IBM Personal Computer and 100% compatibles (with 8086, 8088, 80286 or 80386 
processors) with monochrome or color display; IBM Personal System/2+* Memory: 640K 
recommended; for DESQview itself 0-145K + Expanded Memory (Optional): expanded 
memory boards compatible with the Intel AboveBoard; enhanced expanded memory 
boards compatible with the AST RAMpage> Disk: Two diskette drives or one diskette 
drive and a hard disk+ Graphics Card (Optional): Hercules, IBM Color/Graphics (CGA), 
IBM Enhanced Graphics (EGA), IBM Personal System/2 Advanced Graphics (VGA)+ 
Mouse (Optional); Mouse Systems, Microsoft and compatibles» Modem for Auto-Dialer 
(Optional): Hayes or Compatible + Operating System: PC-DOS 2.0-3.3; MS-DOS2.0-3,2 + 
Software: Most PC-DOS and MS-DOS application programs; programs specific to 
TopView 1.1, GEM 1.1 and Microsoft Windows 1.03+ Media: DESQview 2.0 is available 
on either 54" or 34" floppy diskettes 


Rush me DESQview 2.0! Today! | 
Retail Price ea. ‘Total 


No. of Copies Media 3¥2"/54"__ Product 
DESQview 2.0 $129.95 $ 

| Shipping & Handling USA $ 5.00 | 

Outside USA | $ 10.00 
Sales Tax (CA residents) | 6.5% $ 

| ; < Amount $ | 
Payment: (] Visa MC [JAMEX [)Check Enclosed 
Credit Card: Valid TTT Frere 

| Card Number: [ ] ] | pe | | | Tol 
Credit Card Name 

| Shipping Address. | 
City. State Zip. Telephone 


oe to: Quarterdeck Office Systems, 150 Pico Boulevard, Santa Monica, CA 90405. 
OTE: If you own DESQview call us for a special upgrade offer, or send in your DESQview 
pachinte card. AST Special Edition users included. 


Quarterdeck 


Quarterdeck Office Systems * 150 Pico Boulevard, Santa Monica, CA 90405 ¢ (213) 392-9851 


DESQview is a trademark of Quarterdeck Office Systems, AboveBoard is a trademark of Intel Corporation. Hayes is a trademark of Hayes MicroComputer Products Inc. IBM, PC, Personal System/2 and TopView are 
trademarks of International Business Machines Corporation. Microsoft Windows and MS are registered trade marks of Microsoft Corporation. Mouse Systems is a trademark of Metagraphics/ Mouse Systems. RAMpage 
is a trademark of AST Research, Inc. GEM is a trademark of Digital Research. Hercules is a trademark of Hercules 


How A 
C Programmer 
Became A Screen St 


Screens, the Visible Part 
of Your Program. 
A program is often judged by how well 
the screens are executed. However, 
the real creativity lies in what goes on 
behind the screens. 


ScreenStar is a product that allows your 
real creativity to light up the screen. It 
reduces costly screen, window, and data 
validation development time. 


You Take the Bows, We 
Write the Code. 


Our natural drawing commands allow 
you to paint any screen imaginable. 
Press one key when you are satisfied and 
ScreenStar produces concise, commented, 
ready-to-compile code. This allows 
immediate testing of the I/O screens, 
including smooth, even scrolling 
between multiple screens. 


Create or capture complex screens with 
data-entry filters built in. 


If all ScreenStar did was turn screens 
into code it would be a useful tool. Yet 
ScreenStar also permits a wide range of 
field types. Some of the choices include 
date, alphanumeric, telephone, yes/no, 
dollar, time and user-definable fields. 


Other valuable data-entry filters are 
built in, such as required field, display 
only, and many others. All screen fields 
are generated with error-checking routines. 


ScreenStar is a trademark of Essential Software Inc 
Dan Bricklin’s Demo Program is a trademark of Software Garden Inc. 


ScreenStar Not Only Captures 
Your Imagination, 
It Captures Screens. 
The memory-resident capture program 
converts any screen into a ScreenStar 
file in seconds, including those generated 
by programs like Dan Bricklin’s Demo 
Program. 


ScreenStar Sets the Stage 
for Windows. 

ScreenStar comes with a complete 
window generating library. You design 
the help screens and pop-up windows. 
Essential ScreenStar windowing 
functions tie them together in one 
smooth package. 


Curtain Call. 


They may not ask for your autograph, 
but they will want to know how you did 
those screens. Screenstar is more than a 
screen-painting program. It is a 

screen processor. No professional 


this product. 


We know you will enjoy 
using ScreenStar. However, 
should you give it less than 
rave reviews, return it 
within 30 days for a full 
refund. 


* Interactive screen painting and 
subsequent code generation. 


* Multiple screen design and scrolling. 


* TSR screen capture program, works 
with any program including Dan 
Bricklin’s Demo Program. 


* Complete window design including 
overlapping window functions. 


* Screens are compressed into data 
structures, and remain a permanent part 
of the program. No messy data files to 
look for. 


Price - $99 


W/Source add $99 


Audition Our Product 
Today. Call: 


programming environment will ba . 
be complete without 4. 


i= = (201) 762-6965 


Essential Software 

South Orange Plaza 

76 South Orange Ave., Suite 3 
South Orange, NJ 07079 


